助讯通 WaleChat 文档中心































WaleChat Server SDK 开发接口

1. 给用户单发或多发接口

调用格式:

http://127.0.0.1:6880/post.sdk?recv=1000&send=1001&msg=消息内容

参数说明:

  1. 127.0.0.1:6680,请替换成你服务端所在电脑的IP地址及IM SDK Server进程所使用的端口号(IP与端口号之间用半角冒号相隔开)
  2. recv,接收人UID,请使用前面提到的 wale_user 表中的用户UID 字段,同时给多人发时,请在多个UID之间使用半角逗号隔开即可
  3. send,发送人UID,请使用前面提到的 wale_user 表中的用户UID字段
  4. msg,要发送的实际消息内容,消息内容长度在1024字节以内

2. 给部门或全体(在线)帐号群发接口

调用格式:

http://127.0.0.1:6880/bd.sdk?recv=1,2,3&send=1001&msg=消息内容

参数说明:

  1. 127.0.0.1:6680,请替换成你服务端所在电脑的IP地址及IM SDK Server进程所使用的端口号(IP与端口号之间用半角冒号相隔开)
  2. recv,接收部门的DID,请使用imdept表中的部门DID 字段,同时给多个部门发送时,请在多个DID之间使用半角逗号隔开即可
         如果 recv=all 即表示给所有帐号群发消息
         如果 recv=online 即表示只给所有在线用户群发消息
  3. send,发送人UID,请使用前面提到的 wale_user 表中的用户UID字段
  4. msg,要发送的实际消息内容,消息内容长度在1024字节以内


3. 消息接收接口

调用格式:

请在数据表: wale_config 中,分别添加如下字段值(括号后面的是值的字段名)

sdkrecv=http://127.0.0.1:6880/recv.php ( 发到 SDK 帐号的消息,会转发到此地址,value_string )
sdkuid=1000 ( SDK 所用的登录帐号 UID,value_long )
sdkuser=admin ( SDK 帐号名,value_string )
kernelip=192.168.0.212 ( 核心服务器地址,默认是 127.0.0.1,value_string )
kernelport=6866 ( 核心服务器商品,value_long )

如下图:
SDK 接收消息 接口URL

以上设置原理:

walewebsvr.exe 进程以 帐号名为 1000 的ID作为一个客户端,登录到核心服务器( kernerip 和 kernelport 所指向的核心服务器地址) ,一旦收到有发往此帐号的消息,核心服务器会直接发往 walewebsvr.exe 进程,该进程收到后,会向以上的 sdkrecv 字段值中的 url 地址发送消息

最终:当收到消息后,该 URL 将会被 SDK 服务器调用,调用形式如下:

http://127.0.0.1:6880/recv.sdk?recv=1000&send=1001&msg=消息内容

接受方,只需获取以上 URL 中的三个参数即可,如 php 中的获取方法:

$recv  = $_GET["recv"];
$send  = $_GET["send"];
$msg   = $_GET["msg"];

示例,如下图:

通过顶部的 URL 的 SDK 发送接口,发送了一条消息,SDK 进程中收到发到此 SDK 帐号的消息,同时 该 SDK 帐号,又登录了客户端,相当于同一帐号的两个客户端同时收到了。蓝框中,给顶部 URL 中的 send 用户回复了一条消息,左侧的模拟器,收到了 核心进程 转发给 SDK 服务端的消息( SDK 服务端接着会将此消息向 sdkrecv 字段中的 URL 并转发)。

SDK 接收消息 接口URL



注:以上接口功能只在版本号为 10.0.20 及以上的版本中可用 ...




WaleChat 文档中心
Powered by WaleHelp.com