接Android移動端音視頻的快速開發教程（二）
3.
接口(Interface)說明
AnyChat for Android SDK通過接口（類似於C++的回調函數）實現與上層應用的狀態更新和數據交互。SDK的很多調用都是異步的，如登錄操作，調用函數完成之後，需要等待對應接口的函數來觸發是否登錄成功，總體原則是：需要異步操作的地方，都採用接口來實現。
根據不同的類型，接口也分爲幾大類，在實際的開發過程中，可根據具體情況實現這些接口。
3.1.
基本流程事件接口
“AnyChat在線音視頻互動平臺”採用消息通知的方式來告知系統的各種狀態變化。
3.1.1.
接口定義
package com.bairuitech.anychat;
//AnyChat基本事件接口
public interface AnyChatBaseEvent {
public void OnAnyChatConnectMessage(boolean bSuccess);
public void OnAnyChatLoginMessage(INT UserId, INT ErrorCode);
public void OnAnyChatEnterRoomMessage(INT RoomId, INT ErrorCode);
public void OnAnyChatOnlineUserMessage(INT UserNum, INT RoomId);
public void OnAnyChatUserAtRoomMessage(INT UserId, boolean bEnter);
public void OnAnyChatLinkCloseMessage(INT ErrorCode);
}
3.1.2.
網絡連接事件
方法： public void OnAnyChatConnectMessage(boolean bSuccess)
參數：bSuccess 表示是否連接成功，BOOLEAN類型；
說明：當客戶端連接服務器時被觸發，等同於WIN32平臺的WM_GV_CONNECT消息。
第 14 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權所有
3.1.3.
用戶登錄事件
方法： public void OnAnyChatLoginMessage(int dwUserId, int dwErrorCode)
參數：
dwUserId 表示自己的用戶ID號,當dwErrorCode爲0時有效
dwErrorCode 出錯代碼，可判斷登錄是否成功
說明：當客戶端登錄服務器時被觸發，等同於WIN32平臺的WM_GV_LOGINSYSTEM消息。
3.1.4.
進入房間事件
方法： public void OnAnyChatEnterRoomMessage(int dwRoomId, int dwErrorCode)
參數：
dwRoomId 表示進入的房間ID號
dwErrorCode 出錯代碼，可判斷進入房間是否成功
說明：當客戶端請求進入房間時被觸發，等同於WIN32平臺的WM_GV_ENTERROOM消息。
3.1.5.
房間在線用戶事件
方法： public void OnAnyChatOnlineUserMessage(int dwUserNum, int dwRoomId)
參數：
dwUserNum 表示當前房間的在線用戶數（包含自己）
dwRoomId 房間編號
說明：房間在線用戶消息，進入房間後觸發一次，等同於WIN32平臺的WM_GV_ONLINEUSER消息。收到該消息後，便可對房間中的用戶進行音視頻的相關操作，如請求音頻、請求視頻等。
3.1.6.
房間用戶活動事件
方法： public void OnAnyChatUserAtRoomMessage(int dwUserId, boolean bEnter)
第 15 頁 共 51 頁
AnyChat for Android SDK 開發手冊 佰銳科技 版權所有
參數：
dwUserId 表示當前房間活動用戶的ID號
bEnter true表示進入房間，false表示離開房間
說明：當成功進入房間之後，有新的用戶進入房間，或是房間用戶離開房間，均會觸發該接口，等同於WIN32平臺的WM_GV_USERATROOM消息。
3.1.7.
網絡連接關閉事件
方法： public void OnAnyChatLinkCloseMessage(int dwReason)
參數：
dwReason 表示連接被關閉的原因
說明：當連接服務器成功之後，網絡連接關閉時觸發該接口，等同於WIN32平臺的WM_GV_LINKCLOSE消息。如果已打開本地攝像頭，則上層應用必須在網絡連接關閉事件中關閉本地攝像頭，否則可能造成異常。