# agora::rtc::IRtmpLocalUser类 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## 详细描述 [#详细描述]
[`IRtmpLocalUser`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user) 类。定义了 CDN 推流用户的行为和状态。
每个 CDN 连接都有自己的用户。你可以通过 [getRtmpLocalUser](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection#a87b6eedbf3b26da33c0f65135826349b) 获取本地用户对象的指针。
## 成员枚举类型说明 [#成员枚举类型说明]
### VideoBitrateAdjustType [#videobitrateadjusttype]
enum [agora::rtc::IRtmpLocalUser::VideoBitrateAdjustType](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user#a692c5ab59e1da5664535c3f4df4789b6)
视频编码码率的调节类型。
| 枚举值 |
|
None
|
0: 不调节。 |
|
Increasing
|
1: 增加。每次使用该枚举时,视频编码码率会增加 50 kbps。 |
|
Decreasing
|
2: 减少。每次使用该枚举时,视频编码码率会减少 100 kbps。 |
## 构造及析构函数说明 [#构造及析构函数说明]
### ~IRtmpLocalUser() [#irtmplocaluser]
virtual agora::rtc::IRtmpLocalUser::~IRtmpLocalUser()
## 成员函数说明 [#成员函数说明]
### setAudioStreamConfiguration() [#setaudiostreamconfiguration]
virtual int agora::rtc::IRtmpLocalUser::setAudioStreamConfiguration(const [RtmpStreamingAudioConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-rtmp-streaming-audio-configuration) & *config*)
设置主播端直接向 CDN 推流时的音频编码属性。
CDN 推流的音频编码属性,详见 [RtmpStreamingAudioConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-rtmp-streaming-audio-configuration) 。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### setVideoStreamConfiguration() [#setvideostreamconfiguration]
virtual int agora::rtc::IRtmpLocalUser::setVideoStreamConfiguration(const [RtmpStreamingVideoConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-rtmp-streaming-video-configuration) & *config*)
设置主播端直接向 CDN 推流时的视频编码属性。
CDN 推流的视频编码属性,详见 [RtmpStreamingVideoConfiguration](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-rtmp-streaming-video-configuration) 。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### adjustRecordingSignalVolume() [#adjustrecordingsignalvolume]
virtual int agora::rtc::IRtmpLocalUser::adjustRecordingSignalVolume(int *volume*)
调节主播端直接向 CDN 推流时的音频采集信号音量。
音量,取值范围为 [0,100]。其中:
- 0: 静音。
- 100:(默认)原始音量。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### getRecordingSignalVolume() [#getrecordingsignalvolume]
virtual int agora::rtc::IRtmpLocalUser::getRecordingSignalVolume(int32_t * *volume*)
获取主播端直接向 CDN 推流时的音频采集信号音量。
音量指针。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### setAudioEnabled() [#setaudioenabled]
virtual int agora::rtc::IRtmpLocalUser::setAudioEnabled(bool *enabled*)
在 CDN 推流中开启或关闭本地音频。
你需要在开始直接向 CDN 推流前调用该方法。
是否开启本地音频:
- true:开启
- false:关闭
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### adjustVideoBitrate() [#adjustvideobitrate]
virtual void agora::rtc::IRtmpLocalUser::adjustVideoBitrate([VideoBitrateAdjustType](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user#a692c5ab59e1da5664535c3f4df4789b6) *type*)
调节主播端直接向 CDN 推流时的视频编码码率。
如果多次调用该方法,调节效果会叠加。以当前视频编码码率为 200 kbps 为例:
1. 调用该方法并设置 `type` 为 `Increasing`,则视频编码码率会增加 50 kbps,当前视频编码码率变为 250 kbps。
2. 再次调用该方法并设置 `type` 为 `Decreasing`,则视频编码码率会减少 100 kbps,当前视频编码码率变为 150 kbps。
视频编码码率的调节类型,详见 [VideoBitrateAdjustType](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user#a692c5ab59e1da5664535c3f4df4789b6) 。
### setVideoEnabled() [#setvideoenabled]
virtual int agora::rtc::IRtmpLocalUser::setVideoEnabled(bool *enabled*)
在 CDN 推流中开启或关闭本地视频。
你需要在开始直接向 CDN 推流前调用该方法。
是否开启本地视频:
- true:开启
- false:关闭
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### publishAudio() [#publishaudio]
virtual int agora::rtc::IRtmpLocalUser::publishAudio([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) > *audioTrack*)
向 CDN 推送本地音频流。
本地音频轨道,详见 [ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) 。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### unpublishAudio() [#unpublishaudio]
virtual int agora::rtc::IRtmpLocalUser::unpublishAudio([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) > *audioTrack*)
停止向 CDN 推送本地音频流。
本地音频轨道,详见 [ILocalAudioTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-audio-track) 。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### publishVideo() [#publishvideo]
virtual int agora::rtc::IRtmpLocalUser::publishVideo([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) > *videoTrack*)
向 CDN 推送本地视频流。
本地视频轨道,详见 [ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) 。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### unpublishVideo() [#unpublishvideo]
virtual int agora::rtc::IRtmpLocalUser::unpublishVideo([agora_refptr](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1agora-refptr)< [rtc::ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) > *videoTrack*)
停止向 CDN 推送本地视频流。
本地视频轨道,详见 [ILocalVideoTrack](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-local-video-track) 。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### registerRtmpUserObserver() [#registerrtmpuserobserver]
virtual int agora::rtc::IRtmpLocalUser::registerRtmpUserObserver([IRtmpLocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) * *observer*, void(*)([IRtmpLocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) *) *safeDeleter* = `NULL`)
注册 CDN 推流用户观测器。
成功注册后,你会收到 [`IRtmpLocalUserObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) 类中的相关回调。
[IRtmpLocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) 对象的指针。 你需要在该方法中实现 [`IRtmpLocalUserObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) 类。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### unregisteRtmpUserObserver() [#unregistertmpuserobserver]
virtual int agora::rtc::IRtmpLocalUser::unregisteRtmpUserObserver([IRtmpLocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) * *observer*)
注销 CDN 推流用户观测器。
成功注销后,你将不再收到 [`IRtmpLocalUserObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) 类中的相关回调。
[IRtmpLocalUserObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user-observer) 对象的指针。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### registerAudioFrameObserver() [#registeraudioframeobserver]
virtual int agora::rtc::IRtmpLocalUser::registerAudioFrameObserver(media::base::IAudioFrameObserver * *observer*)
注册音频观测器。
IAudioFrameObserver 对象的指针。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### unregisterAudioFrameObserver() [#unregisteraudioframeobserver]
virtual void agora::rtc::IRtmpLocalUser::unregisterAudioFrameObserver(media::base::IAudioFrameObserver * *observer*)
注销音频观测器。
IAudioFrameObserver 对象的指针。
### registerVideoFrameObserver() [#registervideoframeobserver]
virtual int agora::rtc::IRtmpLocalUser::registerVideoFrameObserver(media::base::IVideoFrameObserver * *observer*)
注册视频观测器。
IVideoFrameObserver 对象的指针。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### unregisterVideoFrameObserver() [#unregistervideoframeobserver]
virtual void agora::rtc::IRtmpLocalUser::unregisterVideoFrameObserver(media::base::IVideoFrameObserver * *observer*)
注销视频观测器。
IVideoFrameObserver 对象的指针。