# agora::rtc::IRtmpConnection类 参考 (/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
继承自 agora::RefCountInterface.
## 详细描述 [#详细描述]
[`IRtmpConnection`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection) 类,用于管理 SDK 与 CDN 之间的连接。
连接完成之后,你可以通过 [IRtmpLocalUser](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user) 对象在 CDN 中推流。
连接 CDN 是异步操作,你可以通过 [IRtmpConnectionObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) 对象监听连接状态变化和事件。
## 构造及析构函数说明 [#构造及析构函数说明]
### ~IRtmpConnection() [#irtmpconnection]
agora::rtc::IRtmpConnection::~IRtmpConnection()
## 成员函数说明 [#成员函数说明]
### connect() [#connect]
virtual int agora::rtc::IRtmpConnection::connect(const char * *url*, aosl_ref_t *ares* = `AOSL_REF_INVALID`)
连接 CDN。
成功调用该方法后,连接状态由 `STATE_DISCONNECTED(1)` 变更为 `STATE_CONNECTING(2)`。
根据连接是否成功,连接状态会有如下变化:
- 连接成功:连接状态变更为 `STATE_CONNECTED(3)`,SDK 会触发 [onConnected](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer#a4048ee1d38dff83649d33bfef93a30f6) 回调。
- 连接失败:连接状态变更为 `STATE_FAILED(5)`,SDK 会触发 [onConnectionFailure](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer#a86658e80515ca6a85ebde8c230c71f16) 回调。
CDN 推流地址。格式为 RTMP。字符长度不能超过 1024 字节。不支持中文字符等特殊字符。
用于 SDK 的生命周期保护,填写默认值即可。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
- -2 (`ERR_INVALID_ARGUMENT`): 参数无效。
- -8(`ERR_INVALID_STATE`): 当前连接状态不是 `STATE_DISCONNECTED(1)`。
### disconnect() [#disconnect]
virtual int agora::rtc::IRtmpConnection::disconnect(aosl_ref_t *ares* = `AOSL_REF_INVALID`)
与 CDN 断开连接。
成功调用该方法后,连接状态变更为 `STATE_DISCONNECTED(1)`,同时 SDK 会触发 [onDisconnected](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer#a676896b8556082f878cb2abfff4f60db) 回调。
用于 SDK 的生命周期保护,填写默认值即可。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### getConnectionInfo() [#getconnectioninfo]
virtual [RtmpConnectionInfo](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-rtmp-connection-info) agora::rtc::IRtmpConnection::getConnectionInfo()
获取连接信息。
返回值
- [RtmpConnectionInfo](/zh-CN/api-reference/rtc-server-sdk/cpp/structagora-1-1rtc-1-1-rtmp-connection-info) 对象:方法调用成功。
- 空指针:方法调用失败。
### getRtmpLocalUser() [#getrtmplocaluser]
virtual [IRtmpLocalUser](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user)* agora::rtc::IRtmpConnection::getRtmpLocalUser()
获取本地用户对象的指针。每个连接仅对应一个本地用户。
返回值
- [IRtmpLocalUser](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-local-user) 对象:方法调用成功。
- 空指针:方法调用失败。
### registerObserver() [#registerobserver]
virtual int agora::rtc::IRtmpConnection::registerObserver([IRtmpConnectionObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) * *observer*, void(*)([IRtmpConnectionObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) *) *safeDeleter* = `NULL`, aosl_ref_t *ares* = `AOSL_REF_INVALID`)
注册 CDN 连接 observer。
你必须先创建 [`IRtmpConnectionObserver`](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) 对象。
[IRtmpConnectionObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) 对象。
用于 SDK 的生命周期保护,填写默认值即可。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。
### unregisterObserver() [#unregisterobserver]
virtual int agora::rtc::IRtmpConnection::unregisterObserver([IRtmpConnectionObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) * *observer*)
销毁 CDN 连接 observer。
[IRtmpConnectionObserver](/zh-CN/api-reference/rtc-server-sdk/cpp/classagora-1-1rtc-1-1-i-rtmp-connection-observer) 对象。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。