ChannelMediaOptions
频道媒体设置选项。
public class ChannelMediaOptions {
public Boolean publishCameraTrack;
public Boolean publishSecondaryCameraTrack;
public Boolean publishMicrophoneTrack;
public Boolean publishScreenCaptureVideo;
public Boolean publishScreenCaptureAudio;
public Boolean publishCustomAudioTrack;
public Integer publishCustomAudioTrackId;
public Boolean publishCustomVideoTrack;
public Boolean publishEncodedVideoTrack;
public Boolean publishMediaPlayerAudioTrack;
public Boolean publishMediaPlayerVideoTrack;
public Boolean publishTranscodedVideoTrack;
public Boolean autoSubscribeAudio;
public Boolean autoSubscribeVideo;
public Boolean enableAudioRecordingOrPlayout;
public Integer publishMediaPlayerId;
public Integer clientRoleType;
public Integer audienceLatencyLevel;
public Integer defaultVideoStreamType;
public Integer channelProfile;
public Integer mediaPlayerAudioDelayMs;
public String token;
public Boolean enableBuiltInMediaEncryption;
public Boolean publishRhythmPlayerTrack;
public Boolean isInteractiveAudience;
public Integer customVideoTrackId;
public Boolean isAudioFilterable;
}
RtcConnection
publishMicrophoneTrack
publishCustomAudioTrack
publishMediaPlayerAudioTrack
true
publishCameraTrack
publishScreenCaptureVideo
publishCustomVideoTrack
publishEncodedVideoTrack
true
注意: 建议你根据业务场景自行设置成员参数值,否则 SDK 会自动对成员参数进行赋值。
publishCameraTrack
设置是否发布摄像头采集的视频:
true
:发布摄像头采集的视频。false
:不发布摄像头采集的视频。
publishMicrophoneTrack
设置是否发布麦克风采集到的音频:
true
:发布麦克风采集到的音频。false
:不发布麦克风采集到的音频。
publishScreenCaptureVideo
设置是否发布屏幕采集的视频:
true
:发布屏幕采集到的视频。false
:不发布屏幕采集到的视频。
publishScreenTrack
改为 publishScreenCaptureVideo
。publishScreenCaptureAudio
设置是否发布屏幕采集的音频:
true
:发布屏幕采集到的音频。false
:不发布屏幕采集到的音频。
publishCustomAudioTrack
设置是否发布自定义采集的音频:
true
:发布自定义采集到的音频。false
:不发布自定义采集到的音频。
publishCustomAudioTrackId
待发布的自定义音频轨道的 ID。默认值为 0。
如果你已在 setExternalAudioSource [2/2]
中设置了 sourceNumber
大于 1,SDK 会创建对应数量的自采集音频轨道,并从 0 开始为每一个音频轨道分配一个 ID。
publishCustomVideoTrack
设置是否发布自定义采集的视频:
true
:发布自定义采集的视频。false
:不发布自定义采集到的视频。
publishEncodedVideoTrack
设置是否发布编码后的视频:
true
:发布编码后的视频 。false
:不发布编码后的视频。
publishMediaPlayerAudioTrack
设置是否发布媒体播放器的音频:
true
:发布媒体播放器的音频。false
:不发布媒体播放器的音频。
publishMediaPlayerVideoTrack
设置是否发布媒体播放器的视频:
true
:发布媒体播放器的视频。false
:不发布媒体播放器的视频。
autoSubscribeAudio
设置是否自动订阅所有音频流:
true
:自动订阅所有音频流。false
:不自动订阅任何音频流。
autoSubscribeVideo
设置是否自动订阅所有视频流:
true
:自动订阅所有视频流。false
:不自动订阅任何视频流。
enableAudioRecordingOrPlayout
设置是否开启音频录制或播放:
true
:开启音频录制或播放。false
:不开启音频录制或播放。
true
。publishMediaPlayerId
待发布的媒体播放器的 ID。默认值为 0。
clientRoleType
用户的角色:
- CLIENT_ROLE_BROADCASTER (1):主播。
- CLIENT_ROLE_AUDIENCE (2):观众。
audienceLatencyLevel
观众端延时级别。
- AUDIENCE_LATENCY_LEVEL_LOW_LATENCY(1): 低延时。
- AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY(2): (默认)超低延时。
defaultVideoStreamType
默认订阅的视频流类型:
- VIDEO_STREAM_HIGH (0):视频大流,即高分辨率、高码率视频流。
- VIDEO_STREAM_LOW (1):视频小流,即低分辨率、低码率视频流。
channelProfile
频道使用场景。
- CHANNEL_PROFILE_COMMUNICATION (0):通信。当频道中只有两个用户时,建议使用该场景。
- CHANNEL_PROFILE_LIVE_BROADCASTING (1):直播。当频道中超过两个用户时,建议使用该场景。
- CHANNEL_PROFILE_GAME (2):游戏语音场景。
废弃请改用 CHANNEL_PROFILE_LIVE_BROADCASTING。 - CHANNEL_PROFILE_CLOUD_GAMING (3):互动。该场景对延时进行了优化。如果你的场景中有用户需要频繁互动,建议使用该场景。
废弃请改用 CHANNEL_PROFILE_LIVE_BROADCASTING。
废弃:
请改用 CHANNEL_PROFILE_LIVE_BROADCASTING。
废弃:
请改用 CHANNEL_PROFILE_LIVE_BROADCASTING。
token
(可选)在服务端生成的用于鉴权的动态密钥。详见使用 Token 鉴权。
警告:
- 该参数仅在调用
updateChannelMediaOptions
或updateChannelMediaOptionsEx
时生效。 - 请确保用于生成 token 的 App ID、频道名和用户名和
create [2/2]
方法初始化引擎时用的 App ID,以及joinChannel [2/2]
或joinChannelEx
方法加入频道时设置的频道名和用户名是一致的。
publishRhythmPlayerTrack
设置是否发布虚拟节拍器声音至远端:
true
:发布。本地用户和远端用户都能听到节拍器。false
:不发布。只有本地用户能听到节拍器。
isInteractiveAudience
是否开启互动观众模式:
true
:开启互动观众模式。成功开启后,本地用户作为互动观众,收到低延时和流畅的远端用户视频。false
:不开启互动观众模式。本地用户作为普通观众,收到默认设置的远端用户视频。
- 该参数用于实现跨直播间连麦场景。连麦主播需要调用
joinChannelEx
方法,以观众身份加入对方的直播间,并将isInteractiveAudience
设置为true
。 - 仅当用户角色为
CLIENT_ROLE_AUDIENCE
时,该参数生效。
customVideoTrackId
调用 createCustomVideoTrack
方法返回的视频轨道 ID。默认值为 0。