播放直播

---

1 简介

登录房间成功后，SDK 会自动拉流播放直播。用户无需手动触发拉流

但如果想获取播放流状态，需要进行回调对象指针的设置。

2 步骤

2.1 初始化 SDK

参考文档：快速开始-初始化

2.2 设置播放回调对象指针

调用如下 API 设置播放回调对象指针。设置回调对象指针失败，会导致 App 收不到相关回调。

AudioRoom-Player.h

/**
 设置直播观众相关信息通知的回调

 @param pCB 回调对象指针
 @return true 成功，false 失败
 */
 bool SetAudioLivePlayerCallback(IAudioLivePlayerCallback *pCB);

2.3 登录房间

调用如下 API 登录房间。无论是手动/自动发布直播模式，登录房间后，SDK 均会自动拉流，无需用户手动操作

AudioRoom.h

/**
 登录房间

 @param pszRoomID 房间 ID，App 需保证其唯一性，长度不可超过 255 byte
 @return true：登录成功，false：登录失败
 @attention 登录房间后，等待 IAudioRoomCallback::OnLoginRoom 回调
 */
 bool LoginRoom(const char* pszRoomID);

AudioRoomCallback.h

/**
 登录房间成功回调

 @param errorCode 错误码，0 表示无错误
 @param pszRoomID 房间 ID
 */
 virtual void OnLoginRoom(int errorCode, const char *pszRoomID) = 0;

常见登录错误码参考如下：

请注意，参数 pszRoomID，是由 App 业务端定义、实现并传入的。开发者在定义 pszRoomID 时需要确保在同一时刻是唯一的。

2.4 处理播放状态回调

自动播放开始后，开发者需在如下回调中处理播放状态和流信息

AudioRoom-Player.h

/**
 播放状态更新回调

 @param stateCode 状态码
 @param pStreamInfo 流信息
 @note 调用 SetAudioLivePlayerCallback 设置回调对象指针成功后，客户端才能收到此回调
 */
 virtual void OnPlayStateUpdate(int stateCode, const ZegoStreamInfo& pStreamInfo) = 0;

常见播放错误码参考如下：

2.5 退出房间

调用如下 API 退出房间。无论是手动/自动发布直播模式，退出房间后，会停止所有的拉流，无需用户手动停止拉流

AudioRoom.h

/**
 退出房间

 @return 成功，false 失败
 @attention 退出登录后，等待 IAudioRoomCallback::OnLogoutRoom 回调
 @note 退出房间会停止所有的推拉流
 */
 bool LogoutRoom();

AudioRoomCallback.h

/**
 退出房间回调

 @param errorCode 错误码，0 表示无错误
 @param pszRoomID 房间 ID
 */
 virtual void OnLogoutRoom(int errorCode, const char *pszRoomID) {}