agora::rtc::IRtmpConnection类 参考

继承自 agora::RefCountInterface.

详细描述Copy Anchor Link

IRtmpConnection 类，用于管理 SDK 与 CDN 之间的连接。

连接完成之后，你可以通过 IRtmpLocalUser 对象在 CDN 中推流。

连接 CDN 是异步操作，你可以通过 IRtmpConnectionObserver 对象监听连接状态变化和事件。

构造及析构函数说明Copy Anchor Link

~IRtmpConnection()Copy Anchor Link

agora::rtc::IRtmpConnection::~IRtmpConnection()

成员函数说明Copy Anchor Link

connect()Copy Anchor Link

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 回调。
• 连接失败：连接状态变更为 STATE_FAILED(5)，SDK 会触发 onConnectionFailure 回调。

返回值

• 0: 方法调用成功。

• < 0: 方法调用失败。

  • -2 (ERR_INVALID_ARGUMENT): 参数无效。
  • -8(ERR_INVALID_STATE): 当前连接状态不是 STATE_DISCONNECTED(1)。

disconnect()Copy Anchor Link

virtual int agora::rtc::IRtmpConnection::disconnect(aosl_ref_t ares = AOSL_REF_INVALID)

与 CDN 断开连接。

成功调用该方法后，连接状态变更为 STATE_DISCONNECTED(1)，同时 SDK 会触发 onDisconnected 回调。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。

getConnectionInfo()Copy Anchor Link

virtual RtmpConnectionInfo agora::rtc::IRtmpConnection::getConnectionInfo()

获取连接信息。

返回值

• RtmpConnectionInfo 对象：方法调用成功。
• 空指针：方法调用失败。

getRtmpLocalUser()Copy Anchor Link

virtual IRtmpLocalUser* agora::rtc::IRtmpConnection::getRtmpLocalUser()

获取本地用户对象的指针。每个连接仅对应一个本地用户。

返回值

• IRtmpLocalUser 对象：方法调用成功。
• 空指针：方法调用失败。

registerObserver()Copy Anchor Link

virtual int agora::rtc::IRtmpConnection::registerObserver(IRtmpConnectionObserver * observer, void(*)(IRtmpConnectionObserver *) safeDeleter = NULL, aosl_ref_t ares = AOSL_REF_INVALID)

注册 CDN 连接 observer。

你必须先创建 IRtmpConnectionObserver 对象。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。

unregisterObserver()Copy Anchor Link

virtual int agora::rtc::IRtmpConnection::unregisterObserver(IRtmpConnectionObserver * observer)

销毁 CDN 连接 observer。

返回值

• 0: 方法调用成功。
• < 0: 方法调用失败。