ChannelMediaOptions
- Android
更新时间
配置频道中的媒体发布和订阅选项。
public class ChannelMediaOptions {
public Boolean publishCameraTrack;
public Boolean publishSecondaryCameraTrack;
public Boolean publishThirdCameraTrack;
public Boolean publishFourthCameraTrack;
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 publishMixedAudioTrack;
public Boolean publishLipSyncTrack;
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 audioDelayMs;
public Integer mediaPlayerAudioDelayMs;
public String token;
public Boolean enableBuiltInMediaEncryption;
public Boolean publishRhythmPlayerTrack;
public Boolean isInteractiveAudience;
public Integer customVideoTrackId;
public Boolean isAudioFilterable;
public Boolean startPreview;
public String parameters;
public Boolean enableMultipath;
public Integer uplinkMultipathMode;
public Integer downlinkMultipathMode;
public Integer preferMultipathType;
}支持在同一个 RtcConnection 中同时发布多个音频流和一个视频流。例如,可以同时启用 publishMicrophoneTrack、publishCustomAudioTrack 和 publishMediaPlayerAudioTrack,但 publishCameraTrack、publishScreenCaptureVideo、publishCustomVideoTrack 和 publishEncodedVideoTrack 中只能有一个设置为 true。
注: 建议你根据业务场景自行设置各成员参数值,否则 SDK 会自动分配默认值。
属性
| 参数名 | 描述 |
|---|---|
publishCameraTrack | 是否发布摄像头采集的视频:
|
publishSecondaryCameraTrack | 是否发布第二路摄像头采集的视频轨道:
|
publishThirdCameraTrack | 是否发布第三路摄像头采集的视频:
|
publishFourthCameraTrack | 是否发布第四路摄像头采集的视频:
|
publishMicrophoneTrack | 是否发布麦克风采集的音频:
|
publishScreenCaptureVideo | 注: 从 v4.0.0 起,参数由 是否发布屏幕采集的视频:
|
publishScreenCaptureAudio | 是否发布屏幕采集的音频:
|
publishCustomAudioTrack | 是否发布自定义音频源采集的音频:
|
publishCustomAudioTrackId | 要发布的自定义音频轨道的 ID。可通过 createCustomAudioTrack 方法获取该 ID。 |
publishCustomVideoTrack | 是否发布自定义视频源采集的视频:
|
publishEncodedVideoTrack | 是否发布编码后的视频:
|
publishMediaPlayerAudioTrack | 是否发布媒体播放器的音频:
|
publishMediaPlayerVideoTrack | 是否发布媒体播放器的视频:
|
publishTranscodedVideoTrack | 是否发布本地转码后的视频轨道:
|
publishMixedAudioTrack | 是否发布音频合流轨道:
|
publishLipSyncTrack | 是否发布由语音驱动扩展处理后的视频轨道:
|
autoSubscribeAudio | 用户加入频道时是否自动订阅所有远端音频流:
|
autoSubscribeVideo | 用户加入频道时是否自动订阅所有远端视频流:
|
enableAudioRecordingOrPlayout | 注: 如果需要发布麦克风采集的音频流,请确保该参数设置为 是否开启音频采集或播放功能:
|
publishMediaPlayerId | 要发布的媒体播放器的 ID。默认值为 0。 |
clientRoleType | 注: 如果将用户角色设置为观众,则无法在频道中发布音视频流。若你希望在直播过程中发布媒体流,请确保将用户角色设置为主播。 用户角色类型:
|
audienceLatencyLevel | 互动直播场景下观众的延迟等级:
|
defaultVideoStreamType | 默认的视频流类型:
|
channelProfile | 频道场景:
|
audioDelayMs | 发送音频帧的延迟(单位:毫秒)。你可以使用该参数设置发送音频帧的延迟,以实现音视频同步。如需关闭延迟,设置该值为 0。 |
mediaPlayerAudioDelayMs | 发送媒体播放器音频帧的延迟(单位:毫秒),用于显式控制音视频同步。如需关闭延迟,设置该值为 0。 |
token | (可选)由你的服务器生成的用于鉴权的 Token。 注: 该参数仅在调用 updateChannelMediaOptions 或 updateChannelMediaOptionsEx 时生效。请确保用于生成 token 的 App ID、频道名和用户名称与调用 create 初始化 RTC 引擎,以及调用 joinChannel 和 joinChannelEx 加入频道时使用的值一致。 |
enableBuiltInMediaEncryption | 注: 调用 updateChannelMediaOptions 方法时将忽略此设置。 是否启用媒体包加密:
|
publishRhythmPlayerTrack | 是否向远端用户发布节拍器的声音:
|
isInteractiveAudience | 注: 该参数仅适用于主播互通场景。联播主播需调用 joinChannelEx 方法以观众身份加入其他主播频道,并将 isInteractiveAudience 设置为 是否开启互动模式:
|
customVideoTrackId | 通过调用 createCustomVideoTrack 方法返回的视频轨道 ID。默认值为 0。 |
isAudioFilterable | |
startPreview | 在已设置画布时,加入频道时是否启动预览:
|
enableMultipath | 注: 权限与系统要求:Android 7.0 或更高版本(API 等级 24 或更高),需要 是否启用多传输路径:
|
preferMultipathType | 首选的传输路径类型。详见 MultipathType。 注: 使用该参数时,需确保 |