私聊函数
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