藍鶯開發者
Web & Mini ProgramiOSAndroidC++Server API

rosterManage#

rosterManage#

好友管理

rosterManage.asyncGetRosterIdList(force) ⇒ Promise.<Array.<number>>#

取得好友id列表

Kind: static method of rosterManage
Returns: Promise.<Array.<number>> - 使用者ID列表

ParamTypeDescription
forceboolean是否強制從伺服器拉取:true - 從伺服器取得, false - 從本地存儲取得

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncGetRosterIdList" %}{% endlanying_code_snippet %}

rosterManage.asyncGetRosterInfo(roster_id, force) ⇒ Promise.<RosterItem>#

取得好友信息

Kind: static method of rosterManage
Returns: Promise.<RosterItem> - 好友信息

ParamTypeDescription
roster_idnumber好友ID
forceboolean是否強制從伺服器拉取: true - 從伺服器拉取, false - 優先從本地存儲取得

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncGetRosterInfo" %}{% endlanying_code_snippet %}

rosterManage.asyncDeleteRoster(param) ⇒ Promise.<boolean>#

刪除好友

Kind: static method of rosterManage
Returns: Promise.<boolean> - 請求結果

ParamTypeDescription
paramobject參數
param.user_idnumber好友的使用者ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncDeleteRoster" %}{% endlanying_code_snippet %}

rosterManage.asnycGetRosterListDetailByIds(roster_ids) ⇒ Promise.<Array.<module:types~RosterItem>>#

根據id列表取得使用者詳細信息

Kind: static method of rosterManage
Returns: Promise.<Array.<module:types~RosterItem>> - 使用者詳細信息列表

ParamTypeDescription
roster_idsArray.<number>使用者ID列表

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asnycGetRosterListDetailByIds" %}{% endlanying_code_snippet %}

rosterManage.getAllRosterDetail() ⇒ Array.<RosterItem>#

取得緩存的所有使用者詳細信息

Kind: static method of rosterManage
Returns: Array.<RosterItem> - 使用者詳細信息列表
Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="getAllRosterDetail" %}{% endlanying_code_snippet %}

rosterManage.asyncGetUserProfile(force) ⇒ Promise.<UserProfile>#

取得自己的使用者信息

Kind: static method of rosterManage
Returns: Promise.<UserProfile> - 使用者信息

ParamTypeDescription
forceboolean是否強制從伺服器拉取: true - 從伺服器拉取, false - 優先從本地存儲取得

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncGetUserProfile" %}{% endlanying_code_snippet %}

rosterManage.getRosterMessageByRid(uid) ⇒ Array.<Meta>#

根據會話ID取得聊天訊息

Kind: static method of rosterManage
Returns: Array.<Meta> - 聊天訊息列表

ParamTypeDescription
uidnumber會話ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="getRosterMessageByRid" %}{% endlanying_code_snippet %}

rosterManage.readRosterMessage(roster_id, mid)#

修改訊息狀態為已讀

Kind: static method of rosterManage

ParamTypeDescription
roster_idnumber會話ID
midnumber訊息ID: 如果不設定 表示把這個會話所有訊息設為已讀

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="readRosterMessage" %}{% endlanying_code_snippet %}

rosterManage.recallMessage(uid, mid)#

撤回訊息,只能撤回5分鐘內的

Kind: static method of rosterManage

ParamTypeDescription
uidnumber會話ID
midnumber訊息ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="recallMessage" %}{% endlanying_code_snippet %}

rosterManage.unreadMessage(uid, mid)#

設定訊息成未讀

Kind: static method of rosterManage

ParamTypeDescription
uidnumber會話ID
midnumber訊息ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="unreadMessage" %}{% endlanying_code_snippet %}

rosterManage.deleteMessage(uid, mid)#

刪除訊息

Kind: static method of rosterManage

ParamTypeDescription
uidnumber會話ID
midnumber訊息ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="deleteMessage" %}{% endlanying_code_snippet %}

rosterManage.appendMessageContent(uid, mid, content)#

追加訊息內容

Kind: static method of rosterManage

ParamTypeDescription
uidnumber會話ID
midnumber訊息ID
contentstring訊息追加內容

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="appendMessageContent" %}{% endlanying_code_snippet %}

rosterManage.replaceMessage(uid, mid, content, config, ext)#

更新訊息內容

Kind: static method of rosterManage

ParamTypeDefaultDescription
uidnumber會話ID
midnumber訊息ID
contentstring訊息更新內容
configstring | objectnull訊息更新配置
extstring | objectnull訊息更新擴展信息

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="replaceMessage" %}{% endlanying_code_snippet %}

rosterManage.getRosterInfo(rid) ⇒ RosterItem#

取得好友信息

Kind: static method of rosterManage
Returns: RosterItem - 好友信息

ParamTypeDescription
ridnumber好友ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="getRosterInfo" %}{% endlanying_code_snippet %}

rosterManage.getUnreadCount(uid) ⇒ number#

取得指定會話的未讀數

Kind: static method of rosterManage
Returns: number - 未讀數

ParamTypeDescription
uidnumber會話ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="getUnreadCount" %}{% endlanying_code_snippet %}

rosterManage.asyncGetApplyList(params) ⇒ Promise.<Array.<module:types~RosterApplication>>#

取得好友申請列表

Kind: static method of rosterManage
Returns: Promise.<Array.<module:types~RosterApplication>> - 好友申請列表

ParamTypeDescription
paramsobject參數
params.cursornumber從哪開始取得:可以傳空字串表示從頭開始取

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncGetApplyList" %}{% endlanying_code_snippet %}

rosterManage.asyncGetBlockedlist(params) ⇒ Promise.<Array.<number>>#

取得黑名單

Kind: static method of rosterManage
Returns: Promise.<Array.<number>> - 使用者ID列表

ParamTypeDescription
paramsobject參數:空物件

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncGetBlockedlist" %}{% endlanying_code_snippet %}

rosterManage.asyncBlockeAdd(params) ⇒ Promise.<boolean>#

加入黑名單

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncBlockeAdd" %}{% endlanying_code_snippet %}

rosterManage.asyncBlockeRemove(params) ⇒ Promise.<boolean>#

移除黑名單

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncBlockeRemove" %}{% endlanying_code_snippet %}

rosterManage.asyncApply(params) ⇒ Promise.<boolean>#

請求加為好友

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID
params.aliasstring備註

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncApply" %}{% endlanying_code_snippet %}

rosterManage.asyncAccept(params) ⇒ Promise.<boolean>#

通過好友申請

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncAccept" %}{% endlanying_code_snippet %}

rosterManage.asyncDecline(params) ⇒ Promise.<boolean>#

拒絕好友申請

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncDecline" %}{% endlanying_code_snippet %}

rosterManage.asyncUpdateRosterExt(params) ⇒ Promise.<boolean>#

修改好友擴展欄位

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID
params.extstring擴展欄位
params.mute_notificationboolean是否接收訊息提醒

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncUpdateRosterExt" %}{% endlanying_code_snippet %}

rosterManage.asyncUpdateRosterAlias(params) ⇒ Promise.<boolean>#

修改好友擴展別名欄位

Kind: static method of rosterManage
Returns: Promise.<boolean> - 是否成功

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID
params.aliasstring備註名稱
params.mute_notificationboolean是否接收訊息提醒

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncUpdateRosterAlias" %}{% endlanying_code_snippet %}

rosterManage.asyncSearchRosterByName(params) ⇒ Promise.<RosterItem>#

按名稱搜索使用者

Kind: static method of rosterManage
Returns: Promise.<RosterItem> - 使用者信息

ParamTypeDescription
paramsobject參數
params.usernamestring使用者名

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncSearchRosterByName" %}{% endlanying_code_snippet %}

rosterManage.asyncSearchRosterById(params) ⇒ Promise.<RosterItem>#

按ID搜索使用者

Kind: static method of rosterManage
Returns: Promise.<RosterItem> - 使用者信息

ParamTypeDescription
paramsobject參數
params.user_idnumber使用者ID

Example

{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncSearchRosterById" %}{% endlanying_code_snippet %}
自動產生的 API 內容,僅在必要位置補充精簡的 AI 解說。