直推 CDN

setDirectCdnStreamingAudioConfiguration:

设置主播端直接向 CDN 推流时的音频编码属性。

Objective-C

- (int)setDirectCdnStreamingAudioConfiguration:(AgoraAudioProfile)profile;

详情

该方法仅对麦克风采集或自采集的音频有效，即对在 AgoraDirectCdnStreamingMediaOptions 中设置 publishMicrophoneTrack 或 publishCustomAudioTrack 为 YES 时所采集的音频有效。

参数

profile

音频编码属性，包含采样率、码率、编码模式和声道数。详见 AgoraAudioProfile。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit

setDirectCdnStreamingVideoConfiguration:

设置主播端直接向 CDN 推流时的视频编码属性。

Objective-C

- (int)setDirectCdnStreamingVideoConfiguration:(AgoraVideoEncoderConfiguration * _Nonnull)config;

详情

该方法仅对摄像头采集、屏幕共享或自采集的视频有效。即对在 AgoraDirectCdnStreamingMediaOptions 中设置 publishCameraTrack 或 publishCustomVideoTrack 为 YES 时所采集的视频有效。

如果你设置的视频分辨率超出你的摄像头设备支持的范围，SDK 会根据你的设置进行自适应，取最接近、且长宽比与你设置的分辨率一致的值进行采集、编码、推流。你可以通过 onDirectCdnStreamingStats: 回调了解推送的视频流的实际分辨率。

参数

config

视频编码参数配置。详见 AgoraVideoEncoderConfiguration。

信息

在直接向 CDN 推流时，SDK 目前仅支持将 AgoraVideoOutputOrientationMode 设为横屏模式（AgoraVideoOutputOrientationModeFixedLandscape）或竖屏模式（AgoraVideoOutputOrientationModeFixedPortrait）。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit

startDirectCdnStreaming:publishUrl:mediaOptions:

设置主播端开始直接向 CDN 推流。

Objective-C

- (int)startDirectCdnStreaming:(id<AgoraDirectCdnStreamingEventDelegate> _Nonnull)delegate publishUrl:(NSString * _Nonnull)publishUrl mediaOptions:(AgoraDirectCdnStreamingMediaOptions * _Nonnull)options;

详情

SDK 不支持同一时间向同一个 URL 重复推流。

媒体选项说明

SDK 不支持 publishCameraTrack 和 publishCustomVideoTrack 同时为 YES，也不支持 publishMicrophoneTrack 和 publishCustomAudioTrack 同时为 YES。你可以根据场景需求设置媒体选项 (AgoraDirectCdnStreamingMediaOptions)。示例如下：

如果你想推送主播端自定义采集的音视频流，请将媒体选项进行如下设置：

• publishCustomAudioTrack 设为 YES 并调用 pushExternalAudioFrameSampleBuffer:sampleRate:channels:trackId: 或 pushExternalAudioFrameRawData:samples:sampleRate:channels:trackId:timestamp:
• publishCustomVideoTrack 设为 YES 并调用 pushExternalVideoFrame:videoTrackId:
• 确保 publishCameraTrack 为 NO (默认值)
• 确保 publishMicrophoneTrack 为 NO (默认值)

自 v4.2.0 起，SDK 支持推送纯音频流。你可以在 AgoraDirectCdnStreamingMediaOptions 中将 publishCustomAudioTrack 或者 publishMicrophoneTrack 设为 YES，并调用 pushExternalAudioFrameSampleBuffer:sampleRate:channels:trackId: 或 pushExternalAudioFrameRawData:samples:sampleRate:channels:trackId:timestamp: 即可推送纯音频流。

信息

在向 CDN 直接推流时，SDK 目前仅支持推送一路音频流及视频流，或一路纯音频流。

参数

delegate

详见 onDirectCdnStreamingStateChanged:reason:message: 及 onDirectCdnStreamingStats:。

publishUrl

CDN 推流 URL。

options

主播端的媒体选项。详见 AgoraDirectCdnStreamingMediaOptions。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit

stopDirectCdnStreaming

设置主播端停止直接向 CDN 推流。

Objective-C

- (int)stopDirectCdnStreaming;

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。详见错误码了解详情和解决建议。

所属接口类

• AgoraRtcEngineKit

onDirectCdnStreamingStateChanged:reason:message:

CDN 推流状态改变回调。

Objective-C

- (void)onDirectCdnStreamingStateChanged:(AgoraDirectCdnStreamingState)state
                                   reason:(AgoraDirectCdnStreamingReason)reason
                                 message:(NSString *_Nullable)message NS_SWIFT_NAME(onDirectCdnStreamingStateChanged(_:reason:message:));

详情

主播端直接向 CDN 推流后，当推流状态改变时，SDK 会触发该回调向你报告新的状态、错误码和信息。你可以据此排查问题。

参数

state

当前推流状态。详见 AgoraDirectCdnStreamingState。

reason

推流状态改变的原因。详见 AgoraDirectCdnStreamingReason。

message

状态改变对应的信息。

所属接口类

• AgoraDirectCdnStreamingEventDelegate

onDirectCdnStreamingStats:

CDN 推流统计数据回调。

Objective-C

- (void)onDirectCdnStreamingStats:(AgoraDirectCdnStreamStats *_Nonnull)stats;

详情

在主播直接向 CDN 推流的过程中，SDK 每隔 1 秒触发一次该回调。

参数

stats

当前推流的统计数据。详见 AgoraDirectCdnStreamingStats。

所属接口类

• AgoraDirectCdnStreamingEventDelegate