com.opentok.BroadcastProperties.Builder
Enclosing class: : BroadcastProperties
public static class BroadcastProperties.Builder extends Object
Used to create a BroadcastProperties object.
See Also:
: - BroadcastProperties
Constructor Summary
Constructors
Constructor
Description
Builder()
Method Summary
All MethodsInstance MethodsConcrete Methods
Modifier and Type
Method
Description
BroadcastProperties.Builder
addRtmpProperties(RtmpProperties rtmpProps)
Call this method to set a list of RTMP broadcast streams.
BroadcastProperties
build()
Builds the BroadcastProperties object.
BroadcastProperties.Builder
hasAudio(boolean hasAudio)
Whether to include audio in the broadcast (true by default).
BroadcastProperties.Builder
hasHls(boolean hasHls)
Call this method to include an HLS broadcast (true) or not false).
BroadcastProperties.Builder
hasVideo(boolean hasVideo)
Whether to include video in the broadcast (true by default).
BroadcastProperties.Builder
hls(Hls hls)
Call this method to include HLS options.
BroadcastProperties.Builder
layout(BroadcastLayout layout)
Customizes the layout of the broadcast.
BroadcastProperties.Builder
maxBitrate(int maxBitrate)
Sets the maximum bitrate in bits per second for broadcast composing.
BroadcastProperties.Builder
maxDuration(int maxDuration)
Sets the maximum duration, in seconds, of the broadcast.
BroadcastProperties.Builder
multiBroadcastTag(String multiBroadcastTag)
Set this to support multiple broadcasts for the same session simultaneously.
BroadcastProperties.Builder
resolution(String resolution)
Sets the resolution of the broadcast stream.
BroadcastProperties.Builder
streamMode(Broadcast.StreamMode streamMode)
Sets the stream mode for this broadcast
When streams are selected automatically (StreamMode.AUTO, the default), all
streams in the session can be included in the archive.
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Constructor Details
Builder
public Builder()
Method Details
layout
public BroadcastProperties.Builder layout(BroadcastLayout layout)
Customizes the layout of the broadcast.
Parameters:
: layout - An object of type BroadcastLayout.
Returns: : The BroadcastProperties.Builder object with the layout setting.
maxDuration
public BroadcastProperties.Builder maxDuration(int maxDuration) throws InvalidArgumentException
Sets the maximum duration, in seconds, of the broadcast. The broadcast will automatically stop when the maximum duration is reached. You can set the maximum duration to a value from 60 (60 seconds) to 36000 (10 hours). The default maximum duration is 2 hours (7200 seconds).
Parameters:
: maxDuration - The maximum duration in seconds.
Returns: : The BroadcastProperties.Builder object with the maxDuration setting.
Throws:
: InvalidArgumentException
maxBitrate
public BroadcastProperties.Builder maxBitrate(int maxBitrate) throws InvalidArgumentException
Sets the maximum bitrate in bits per second for broadcast composing.
Parameters:
: maxBitrate - The maximum bitrate in bits per second.
Returns: : The BroadcastProperties.Builder object with the maxBitrate setting.
Throws:
: InvalidArgumentException - If the bitrate is out of bounds.
hasHls
public BroadcastProperties.Builder hasHls(boolean hasHls)
Call this method to include an HLS broadcast (true) or not false).
Parameters:
: hasHls - Whether the HLS broadcast is enabled or not.
Returns: : The BroadcastProperties.Builder object with the HLS setting.
hls
public BroadcastProperties.Builder hls(Hls hls)
Call this method to include HLS options. This will set hasHls to true.
Parameters:
: hls - The HLS object.
Returns: : The BroadcastProperties.Builder object with HLS populated.
hasAudio
public BroadcastProperties.Builder hasAudio(boolean hasAudio)
Whether to include audio in the broadcast (true by default).
Parameters:
: hasAudio - true if audio should be included, false otherwise.
Returns: : The BroadcastProperties.Builder object with the hasAudio setting.
hasVideo
public BroadcastProperties.Builder hasVideo(boolean hasVideo)
Whether to include video in the broadcast (true by default).
Parameters:
: hasVideo - true if video should be included, false otherwise.
Returns: : The BroadcastProperties.Builder object with the hasVideo setting.
addRtmpProperties
public BroadcastProperties.Builder addRtmpProperties(RtmpProperties rtmpProps) throws InvalidArgumentException
Call this method to set a list of RTMP broadcast streams. There is a limit of 5 RTMP streams.
Parameters:
: rtmpProps - The RtmpProperties object defining the RTMP streams.
Returns: : The BroadcastProperties.Builder object with the list of RtmpProperties setting.
Throws:
: InvalidArgumentException
resolution
public BroadcastProperties.Builder resolution(String resolution)
Sets the resolution of the broadcast stream.
Parameters:
: resolution - The resolution of the broadcast, either "640x480" (SD, the default),
"1280x720" (HD) or "1920x1080" (FHD).
Returns: : The BroadcastProperties.Builder object with the resolution setting.
streamMode
public BroadcastProperties.Builder streamMode(Broadcast.StreamMode streamMode)
Sets the stream mode for this broadcast
When streams are selected automatically (StreamMode.AUTO, the default), all
streams in the session can be included in the archive. When streams are selected manually
(StreamMode.MANUAL), you specify streams to be included based on calls
to the OpenTok.addBroadcastStream(String, String, boolean, boolean) and
OpenTok.removeBroadcastStream(String, String) methods. With
StreamMode.MANUAL, you can specify whether a stream's audio, video, or both
are included in the archive. Un both automatic and manual modes, the archive composer
includes streams based on
stream
prioritization rules.
Parameters:
: streamMode - Set to a value defined in the Broadcast.StreamMode enum.
Returns: : The BroadcastProperties.Builder object with the stream mode string.
multiBroadcastTag
public BroadcastProperties.Builder multiBroadcastTag(String multiBroadcastTag)
Set this to support multiple broadcasts for the same session simultaneously. Set this to a unique string for each simultaneous broadcast of an ongoing session. See Simultaneous Broadcasts documentation.
Parameters:
: multiBroadcastTag - A unique multi-broadcast tag.
Returns: : The BroadcastProperties.Builder object with the multiBroadcastTag setting.
build
public BroadcastProperties build()
Builds the BroadcastProperties object.
Returns: : The BroadcastProperties object.