# 直推 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)。