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

.net