直推 CDN
setDirectCdnStreamingAudioConfiguration
设置主播直接 CDN 推流的音频配置。
Java
public abstract int setDirectCdnStreamingAudioConfiguration(int profile)
废弃
当你在 DirectCdnStreamingMediaOptions 中将 publishMicrophoneTrack 或 publishCustomAudioTrack 设置为 true 时,可以调用该方法设置音频配置。
参数
- profile
- 音频配置,包括采样率、码率、编码模式和声道数:
DEFAULT(0):默认配置。- 互动直播场景:采样率为 48 kHz,音乐编码,单声道,码率最高为 64 Kbps。
- 通信场景:采样率为 32 kHz,语音编码,单声道,码率最高为 18 Kbps。
SPEECH_STANDARD(1):采样率为 32 kHz,语音编码,单声道,码率最高为 18 Kbps。MUSIC_STANDARD(2):采样率为 48 kHz,音乐编码,单声道,码率最高为 64 Kbps。MUSIC_STANDARD_STEREO(3):采样率为 48 kHz,音乐编码,立体声,码率最高为 80 Kbps。MUSIC_HIGH_QUALITY(4):采样率为 48 kHz,音乐编码,单声道,码率最高为 96 Kbps。MUSIC_HIGH_QUALITY_STEREO(5):采样率为 48 kHz,音乐编码,立体声,码率最高为 128 Kbps。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
setDirectCdnStreamingVideoConfiguration
设置主播直接 CDN 推流的视频属性配置。
Java
public abstract int setDirectCdnStreamingVideoConfiguration(VideoEncoderConfiguration config);
废弃
该方法仅影响通过摄像头、屏幕或自定义视频源采集的视频流。也就是说,当你在 DirectCdnStreamingMediaOptions 中将 publishCameraTrack 或 publishCustomVideoTrack 设置为 true 时,可以调用该方法设置视频属性配置。 如果本地摄像头不支持你设置的视频分辨率,SDK 会自动将其调整为最接近的分辨率进行采集、编码或推流,并保持你设置的分辨率的宽高比。你可以通过 onDirectCdnStreamingStats 回调获取视频流的实际分辨率。
信息
在 CDN 直播过程中,声网仅支持将 ORIENTATION_MODE 设置为
ORIENTATION_MODE_FIXED_LANDSCAPE 或 ORIENTATION_MODE_FIXED_PORTRAIT。参数
- config
- 视频属性配置。详见 VideoEncoderConfiguration。信息在 CDN 直播过程中,声网仅支持将 ORIENTATION_MODE 设置为
ORIENTATION_MODE_FIXED_LANDSCAPE或ORIENTATION_MODE_FIXED_PORTRAIT。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
startDirectCdnStreaming
开始将媒体流直接推送到 CDN。
Java
public abstract int startDirectCdnStreaming(IDirectCdnStreamingEventHandler eventHandler, String publishUrl, DirectCdnStreamingMediaOptions options);
废弃
声网不支持同时将
publishCameraTrack 和 publishCustomVideoTrack 设置为 true,或将 publishMicrophoneTrack 和 publishCustomAudioTrack 设置为 true。在选择媒体设置选项(DirectCdnStreamingMediaOptions)时,你可以参考以下示例: 如果你希望从自定义源推送由主播采集的音视频流,媒体设置选项应如下设置: - 将
publishCustomAudioTrack设置为 true,并调用 pushExternalAudioFrame 方法; - 将
publishCustomVideoTrack设置为 true,并调用pushExternalVideoFrameById方法; - 将
publishCameraTrack设置为 false(默认值); - 将
publishMicrophoneTrack设置为 false(默认值)。
publishCustomAudioTrack 或 publishMicrophoneTrack 设置为 true,并调用 pushExternalAudioFrame 推送音频流。信息
声网仅支持将一路音视频流或一路音频流推送到 CDN。
参数
- eventHandler
- 事件回调接口。详见 IDirectCdnStreamingEventHandler。
- publishUrl
- CDN 推流地址。
- options
- 主播的媒体设置选项。详见 DirectCdnStreamingMediaOptions。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
stopDirectCdnStreaming
onDirectCdnStreamingStateChanged
CDN 推流状态发生变化回调。
Java
void onDirectCdnStreamingStateChanged(DirectCdnStreamingState state, DirectCdnStreamingReason reason, String message)
当主播直接向 CDN 推流时,如果推流状态发生变化,SDK 会触发该回调,报告变化后的推流状态、错误码及其他信息。你可以参考该回调进行问题排查。
触发时机
该回调在主播直接向 CDN 推流过程中,推流状态发生变化时被触发。
参数
- state
- 当前的 CDN 推流状态。详见 DirectCdnStreamingState。
- reason
- CDN 推流状态变化的原因。详见 DirectCdnStreamingReason。
- message
- 关于推流状态变化的说明信息。
onDirectCdnStreamingStats
上报 CDN 推流统计信息的回调。
Java
void onDirectCdnStreamingStats(DirectCdnStreamingStats stats)
当主播直接向 CDN 推送媒体流时,SDK 每秒触发一次该回调。
触发时机
该回调在主播直接向 CDN 推送媒体流时每秒触发一次。
参数
- stats
- 当前 CDN 推流的统计信息,详见 DirectCdnStreamingStats。