agora::rtc::IRtmpConnection Class Reference

#include <NGIAgoraRtmpConnection.h>

Public Member Functions
	~IRtmpConnection ()
virtual int	connect (const char *url)=0
virtual int	disconnect ()=0
virtual RtmpConnectionInfo	getConnectionInfo ()=0
virtual IRtmpLocalUser *	getRtmpLocalUser ()=0
virtual int	registerObserver (IRtmpConnectionObserver *observer, void(*safeDeleter)(IRtmpConnectionObserver *)=NULL)=0
virtual int	unregisterObserver (IRtmpConnectionObserver *observer)=0

Detailed Description

The IRtmpConnection class. You can use this class for managing the connection between the SDK and CDN.

Once connected, your app gets an IRtmpLocalUser object for pushing audio and video streams to the CDN.

Connecting to the CDN is done asynchronously, and your app can listen for the connection states or events through IRtmpConnectionObserver.

Constructor & Destructor Documentation

~IRtmpConnection()

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

inline

Member Function Documentation

connect()

virtual int agora::rtc::IRtmpConnection::connect ( const char *  url )

pure virtual

Connects to the CDN.

When the method call succeeds, the connection state changes from STATE_DISCONNECTED(1) to STATE_CONNECTING(2).

Depending on whether the connection is successful, the connection state changes as follows:

• Success: The connection state changes to STATE_CONNECTED(3), and the SDK triggers the onConnected callback.
• Failure: The connection state changes to STATE_FAILED(5), and the SDK triggers the onConnectionFailure callback.

Parameters

url	The address of the CDN streaming. The format is RTMP. The character length cannot exceed 1,024 bytes. Special characters such as Chinese characters are not supported.

Returns

• 0: Success.
• < 0: Failure.
  • -2(ERR_INVALID_ARGUMENT): The parameter is invalid.
  • -8(ERR_INVALID_STATE): The current connection state is not STATE_DISCONNECTED(1).

disconnect()

virtual int agora::rtc::IRtmpConnection::disconnect ( )

pure virtual

Disconnects from the CDN.

When the method call succeeds, the connection state changes to STATE_DISCONNECTED(1), and the SDK triggers the onDisconnected callback.

Returns

• 0: Success.
• < 0: Failure.

getConnectionInfo()

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

pure virtual

Gets the connection information.

Returns

• A pointer to the RtmpConnectionInfo object: Success.
• A null pointer: Failure.

getRtmpLocalUser()

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

pure virtual

Gets a pointer to the local user object.

Each connection corresponds to only one local user.

Returns

• A pointer to the IRtmpLocalUser object: Success.
• A null pointer: Failure.

registerObserver()

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

pure virtual

Registers the CDN connection observer.

You can call this method only after creating an IRtmpConnectionObserver object.

Parameters

observer

The pointer to the IRtmpConnectionObserver object.

Returns

• 0: Success.
• < 0: Failure.

unregisterObserver()

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

pure virtual

Releases the registered CDN connection observer.

Parameters

observer

The pointer to the IRtmpConnectionObserver object.

Returns

• 0: Success.
• < 0: Failure.

---

The documentation for this class was generated from the following file:

• NGIAgoraRtmpConnection.h