### **進入房間（根據房間編號）** 函數：BRAC_EnterRoom(INT dwRoomid, STRING lpRoomPass, INT dwParam) 功能：根據房間編號進入房間 參數： dwRoomid 整形值，房間編號，系統唯一； lpRoomPass 字符串值，房間密碼（當房間需要密碼時有效，如果沒有可為空）； dwParam 整形值，備用參數（進入房間時傳0） 返回值：0表示成功，否則為出錯代碼； 說明： 該方法可以登錄系統之后立即調用，而不用關心登錄系統是否成功，當SDK登錄系統成功之后，如果之前調用過該方法，則SDK將會自動向服務器發出進入房間的申請。 返回值為0并不表示進入房間成功，僅表示SDK已成功收到進入房間的指令，不論成功，或是失敗，都將會通過相應的接口通知上層應用，這里是一個異步的過程。 用戶必須進入一個房間，否則無法進行相關的操作，后續用戶所有的操作都是在房間內操作，針對游戲，房間可以理解為游戲桌（一桌游戲對應一個房間），針對視頻會議，房間可以理解為會議室。 如果服務器配置了“SDK Filter Plus”插件，則客戶端調用該方法后，將會觸發其API接口：BRFP_PrepareEnterRoom，用戶ID、房間ID、房間密碼將會作為參數傳遞給該API函數，由“SDK Filter Plus”完成用戶進入房間的驗證工作，服務器根據該API接口的返回值來判定是否允許進入房間，詳細信息可參考文檔《AnyChat SDK Filter Plus開發指南》。 如果在服務器端使用“AnyChat Server SDK”開發了業務層服務器，則客戶端調用該方法后，將會觸發業務層服務器的回調函數“BRAS_PrepareEnterRoom_CallBack”，由業務層服務器完成用戶進入房間的驗證工作，服務器根據該API接口的返回值來判定是否允許進入房間，詳細信息可參考文檔《AnyChat Server SDK 開發指南》。 ### **進入房間（根據房間名稱）** 函數：BRAC_EnterRoomEx(STRING lpRoomName, STRING lpRoomPass) 功能：根據房間名稱進入房間 參數： lpRoomName 字符串值，房間名稱； lpRoomPass 字符串值，房間密碼（當房間需要密碼時有效，如果沒有可為空）； 返回值：0表示成功， 否則為出錯代碼； 說明： 該方法與“BRAC_EnterRoom”功能相同，區別在于房間的標識不同，其中“BRAC_EnterRoom”是用房間ID進入房間，而該方法是用房間名稱進入房間，如果房間不存在，而且系統配置為自動創建房間時，將會由系統分配一個唯一的房間編號，通過基本事件回調函數返回給上層應用。 回調函數 ~~~ // 客戶端進入房間，dwRoomId表示所進入房間的ID號，errorcode表示是否進入房間：0成功進入，否則為出錯代碼 function OnAnyChatEnterRoom(dwRoomId, errorcode) { } ~~~ ~~~ // 收到當前房間的在線用戶信息，進入房間后觸發一次，dwUserCount表示在線用戶數（包含自己），dwRoomId表示房間ID function OnAnyChatRoomOnlineUser(dwUserCount, dwRoomId) { } ~~~ ~~~ // 用戶進入（離開）房間，dwUserId表示用戶ID號，bEnterRoom表示該用戶是進入（1）或離開（0）房間 function OnAnyChatUserAtRoom(dwUserId, bEnterRoom) { } ~~~