# 直推 CDN (/zh-CN/api-reference/rtc/csharp-windows/cloud-media-relay/cdn-streaming) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## SetDirectCdnStreamingAudioConfiguration [#setdirectcdnstreamingaudioconfiguration] 设置主播端直接向 CDN 推流时的音频编码属性。 ```csharp public abstract int SetDirectCdnStreamingAudioConfiguration(AUDIO_PROFILE_TYPE profile); ``` ### 参数 [#参数] 音频编码属性,包含采样率、码率、编码模式和声道数。详见 [AUDIO_PROFILE_TYPE](/zh-CN/api-reference/rtc/csharp-windows/enum-audioprofiletype)。 ### 返回值 [#返回值] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## SetDirectCdnStreamingVideoConfiguration [#setdirectcdnstreamingvideoconfiguration] 设置主播端直接向 CDN 推流时的视频编码属性。 ```csharp public abstract int SetDirectCdnStreamingVideoConfiguration(VideoEncoderConfiguration config); ``` ### 详情 [#详情] 该方法仅对摄像头采集、屏幕共享或自采集的视频有效。即对在 [DirectCdnStreamingMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-directcdnstreamingmediaoptions) 中设置 publishCameraTrack 或 publishCustomVideoTrack 为 `true` 时所采集的视频有效。 如果你设置的视频分辨率超出你的摄像头设备支持的范围,SDK 会根据你的设置进行自适应,取最接近、且长宽比与你设置的分辨率一致的值进行采集、编码、推流。你可以通过 [OnDirectCdnStreamingStats](/zh-CN/api-reference/rtc/csharp-windows/cloud-media-relay/cdn-streaming#callback_idirectcdnstreamingeventhandler_ondirectcdnstreamingstats) 回调了解推送的视频流的实际分辨率。 ### 参数 [#参数-1] 视频编码参数配置。详见 [VideoEncoderConfiguration](/zh-CN/api-reference/rtc/csharp-windows/class-videoencoderconfiguration)。 :::note 注: 在直接向 CDN 推流时,SDK 目前仅支持将 ORIENTATION_MODE 设为横屏模式(ORIENTATION_MODE_FIXED_LANDSCAPE)或竖屏模式(ORIENTATION_MODE_FIXED_PORTRAIT)。 ::: ### 返回值 [#返回值-1] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-1] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## StartDirectCdnStreaming [#startdirectcdnstreaming] 设置主播端开始直接向 CDN 推流。 ```csharp public abstract int StartDirectCdnStreaming(string publishUrl, DirectCdnStreamingMediaOptions options); ``` ### 详情 [#详情-1] SDK 不支持同一时间向同一个 URL 重复推流。 **媒体选项说明** SDK 不支持 publishCameraTrack 和 publishCustomVideoTrack 同时为 `true`,也不支持 publishMicrophoneTrack 和 publishCustomAudioTrack 同时为 `true`。你可以根据场景需求设置媒体选项 ([DirectCdnStreamingMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-directcdnstreamingmediaoptions))。示例如下: 如果你想推送主播端自定义采集的音视频流,请将媒体选项进行如下设置: - publishCustomAudioTrack 设为 `true` 并调用 [PushAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_pushaudioframe0) - publishCustomVideoTrack 设为 `true` 并调用 [PushVideoFrame](/zh-CN/api-reference/rtc/csharp-windows/video/video-custom-capturenrendering#api_imediaengine_pushvideoframe) - 确保 publishCameraTrack 为 `false` (默认值) - 确保 publishMicrophoneTrack 为 `false` (默认值) 自 v4.2.0 起,SDK 支持推送纯音频流。你可以在 [DirectCdnStreamingMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-directcdnstreamingmediaoptions) 中将 publishCustomAudioTrack 或者 publishMicrophoneTrack 设为 `true`,并调用 [PushAudioFrame](/zh-CN/api-reference/rtc/csharp-windows/audio/audio-custom-capturenrendering#api_imediaengine_pushaudioframe0) 即可推送纯音频流。 :::note 注: 在向 CDN 直接推流时,SDK 目前仅支持推送一路音频流及视频流,或一路纯音频流。 ::: ### 参数 [#参数-2] CDN 推流 URL。 主播端的媒体选项。详见 [DirectCdnStreamingMediaOptions](/zh-CN/api-reference/rtc/csharp-windows/class-directcdnstreamingmediaoptions)。 ### 返回值 [#返回值-2] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-2] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## StopDirectCdnStreaming [#stopdirectcdnstreaming] 设置主播端停止直接向 CDN 推流。 ```csharp public abstract int StopDirectCdnStreaming(); ``` ### 详情 [#详情-2] ### 返回值 [#返回值-3] - 0: 方法调用成功。 - < 0: 方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。 ### 所属接口类 [#所属接口类-3] - [IRtcEngine](/zh-CN/api-reference/rtc/csharp-windows/rtc-interface-class#class_irtcengine) ## OnDirectCdnStreamingStateChanged [#ondirectcdnstreamingstatechanged] CDN 推流状态改变回调。 ```csharp public virtual void OnDirectCdnStreamingStateChanged(DIRECT_CDN_STREAMING_STATE state, DIRECT_CDN_STREAMING_REASON reason, string message) ``` ### 详情 [#详情-3] 主播端直接向 CDN 推流后,当推流状态改变时,SDK 会触发该回调向你报告新的状态、错误码和信息。你可以据此排查问题。 ### 参数 [#参数-3] 当前推流状态。详见 [DIRECT_CDN_STREAMING_STATE](/zh-CN/api-reference/rtc/csharp-windows/enum-directcdnstreamingstate)。 推流状态改变的原因。详见 [DIRECT_CDN_STREAMING_REASON](/zh-CN/api-reference/rtc/csharp-windows/enum-directcdnstreamingreason)。 状态改变对应的信息。 ## OnDirectCdnStreamingStats [#ondirectcdnstreamingstats] CDN 推流统计数据回调。 ```csharp public virtual void OnDirectCdnStreamingStats(DirectCdnStreamingStats stats) { } ``` ### 详情 [#详情-4] 在主播直接向 CDN 推流的过程中,SDK 每隔 1 秒触发一次该回调。 ### 参数 [#参数-4] 当前推流的统计数据。详见 [DirectCdnStreamingStats](/zh-CN/api-reference/rtc/csharp-windows/class-directcdnstreamingstats)。