接
4.6.
私聊函数 4.6.1. 更改当前的聊天模式 INT ChangeChatMode(INT ChatMode); 功能:更改自己的聊天模式(默认为公聊模式) 返回值:0表示成功,否则为出错代码 参数: dwChatMod: 聊天模式,定义为: GV_CHATMODE_PUBLIC 0 公聊模式 GV_CHATMODE_PRIVATE 1 私聊模式 备注: 不同的聊天模式下对语音视频数据的发送方式采取了不同的策略,公聊模式下可以接收所有的视频和语音信息,而私聊模式下只接收与自己私聊的用户的语音和视频数据,在私聊模式下,自己的语音视频数据也只向私聊对象传送。 该方法必须在进入房间成功之后调用方才有效,在私聊模式下,接收不到其它用户的语音和视频数据,仅能接收到自己私聊对象的语音和视频数据,文字消息不受模式影响,关于私聊模式与公聊模式之间的关系,请参考“关于私聊的实现思路” 部分。 第 41 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权所有 4.6.2. 获取指定用户聊天模式 INT GetUserChatMode(INT Userid, INT& dwChatMode); 功能:获取指定用户当前的聊天模式。 返回值:0表示成功,否则为出错代码 参数: dwUserid: 用户ID号,-1表示获取自己的聊天模式; dwChatMod: 聊天模式 备注: 该方法必须在进入房间成功之后调用方才有效。 4.6.3. 请求与对方私聊 INT PrivateChatRequest(INT Userid); 功能:请求与对方私聊,向对方发起私聊请求。 返回值:0表示成功,否则为出错代码 参数: dwUserid: 对方的用户ID号 备注: 该方法必须在进入房间成功之后调用方才有效。如果对方接受请求,则系统将会自动切换到私聊模式,调用该方法后,对方将会收到消息:WM_GV_PRIVATEREQUEST。 4.6.4. 回复对方的私聊请求 INT PrivateChatEcho(INT Userid, INT Requestid, BOOLEAN bAccept); 功能:回复对方的私聊请求。 返回值:0表示成功,否则为出错代码 参数: 第 42 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权所有 dwUserid: 对方的用户ID号 dwRequestid: 请求ID号,在请求消息中传过来,标示是哪一个请求 bAccept: 是否同意对方的私聊请求 备注: 该方法必须在进入房间成功之后调用方才有效。当收到其它用户的私聊请求时,可以调用该方法同意,或是拒绝对方的请求,调用该方法后,对方将会收到消息:WM_GV_PRIVATEECHO。 4.6.5. 回复对方的私聊请求(扩展) INT PrivateChatEchoEx(INT Userid, INT Requestid, INT ErrorCode); 功能:回复对方的私聊请求。 返回值:0表示成功,否则为出错代码 参数: dwUserid: 对方的用户ID号 dwRequestid: 请求ID号,在请求消息中传过来,标示是哪一个请求 dwErrorCode: 是否同意对方的私聊请求(errorcode=GV_ERR_SUCCESS表示同意与对方私聊,否则表示拒绝与对方私聊) 备注: 该方法与“PrivateChatEcho”功能相同,但是该方法可以让上层传入相应的出错代码,指示拒绝的原因,便于上层扩展,传入的errorcode将会附带在对方收到的WM_GV_PRIVATEECHO消息中。 4.6.6. 退出与某用户的私聊 INT PrivateChatExit(INT Userid); 功能:退出与某用户的私聊,或者将某用户从自己的私聊列表中清除。 返回值:0表示成功,否则为出错代码 参数: 第 43 页 共 51 页 AnyChat for Android SDK 开发手册 佰锐科技 版权所有 dwUserid: 对方的用户ID号 备注: 该方法必须在进入房间成功之后调用方才有效。因为同时可以和多个用户之间进行私聊,所以断开与该用户的私聊连接后,不影响与其它用户的私聊,调用该方法后,自己和对方都将会收到消息:WM_GV_PRIVATEEXIT