### **进入房间（根据房间编号）** 函数：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) { } ~~~