DingRtmClient接口

接口说明

目录

接口详情

• setListener： 设置消息服务的回调。

   public abstract void setListener (DingRtmEventListener listener)

  参数	类型	描述
  listener	DingRtmEventListener	用于接收来自RTM服务的回调事件。

  重要

  需要在入会前设置监听，否则可能丢失部分RTM事件回调。

• joinSession： 加入Session。如果之前存在此Session，直接加入；否则会先创建Session并加入。

   public abstract int joinSession (String sessionId)

  参数	类型	描述
  sessionId	String	SessionID。只允许[A-Za-z0-9_-]，不超过64个字符。

  返回说明

  • 0：成功；
  • <0：失败。
  重要

  自己会收到onJoinSessionResult回调，Session里的其他用户会收到onSessionRemoteUserJoin通知。

• leaveSession： 离开Session。

   public abstract int leaveSession (String sessionId)

  参数	类型	描述
  sessionId	String	SessionID。

  返回说明

  • 0：成功；
  • <0：失败。
  重要

  自己会收到onLeaveSessionResult回调，Session里的其他用户会收到onSessionRemoteUserLeave通知。

• closeSession： 关闭Session。

   public abstract int closeSession (String sessionId)

  参数	类型	描述
  sessionId	String	SessionID。

  返回说明

  • 0：成功；
  • <0：失败。
  重要

  自己会收到onCloseSessionResult回调，Session里的所有用户都会收到onSessionClose通知，Session关闭后不再可用。

• sendData： 发送消息给Session里的指定用户。

   public abstract int sendData (String sessionId, String toUid, byte[] data)

  参数	类型	描述
  sessionId	String	SessionID。
  toUid	String	消息接收方用户ID。
  data	byte[]	消息数据。

  返回说明

  • 0：成功；
  • <0：失败。

• broadcastData： 广播消息给Session里的所有用户。

   public abstract int broadcastData (String sessionId, byte[] data)

  参数	类型	描述
  sessionId	String	SessionID。
  data	byte[]	消息数据。支持UTF-8编码的字符串和二进制数据。

  返回说明

  • 0：成功；
  • <0：失败。