rosterManage#
rosterManage#
好友管理
- rosterManage
- .asyncGetRosterIdList(force) ⇒
Promise.<Array.<number>> - .asyncGetRosterInfo(roster_id, force) ⇒
Promise.<RosterItem> - .asyncDeleteRoster(param) ⇒
Promise.<boolean> - .asnycGetRosterListDetailByIds(roster_ids) ⇒
Promise.<Array.<module:types~RosterItem>> - .getAllRosterDetail() ⇒
Array.<RosterItem> - .asyncGetUserProfile(force) ⇒
Promise.<UserProfile> - .getRosterMessageByRid(uid) ⇒
Array.<Meta> - .readRosterMessage(roster_id, mid)
- .recallMessage(uid, mid)
- .unreadMessage(uid, mid)
- .deleteMessage(uid, mid)
- .appendMessageContent(uid, mid, content)
- .replaceMessage(uid, mid, content, config, ext)
- .getRosterInfo(rid) ⇒
RosterItem - .getUnreadCount(uid) ⇒
number - .asyncGetApplyList(params) ⇒
Promise.<Array.<module:types~RosterApplication>> - .asyncGetBlockedlist(params) ⇒
Promise.<Array.<number>> - .asyncBlockeAdd(params) ⇒
Promise.<boolean> - .asyncBlockeRemove(params) ⇒
Promise.<boolean> - .asyncApply(params) ⇒
Promise.<boolean> - .asyncAccept(params) ⇒
Promise.<boolean> - .asyncDecline(params) ⇒
Promise.<boolean> - .asyncUpdateRosterExt(params) ⇒
Promise.<boolean> - .asyncUpdateRosterAlias(params) ⇒
Promise.<boolean> - .asyncSearchRosterByName(params) ⇒
Promise.<RosterItem> - .asyncSearchRosterById(params) ⇒
Promise.<RosterItem>
rosterManage.asyncGetRosterIdList(force) ⇒ Promise.<Array.<number>>#
取得好友id列表
Kind: static method of rosterManage
Returns: Promise.<Array.<number>> - 使用者ID列表
| Param | Type | Description |
|---|---|---|
| force | boolean | 是否強制從伺服器拉取: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> - 好友信息
| Param | Type | Description |
|---|---|---|
| roster_id | number | 好友ID |
| force | boolean | 是否強制從伺服器拉取: 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> - 請求結果
| Param | Type | Description |
|---|---|---|
| param | object | 參數 |
| param.user_id | number | 好友的使用者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>> - 使用者詳細信息列表
| Param | Type | Description |
|---|---|---|
| roster_ids | Array.<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> - 使用者信息
| Param | Type | Description |
|---|---|---|
| force | boolean | 是否強制從伺服器拉取: 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> - 聊天訊息列表
| Param | Type | Description |
|---|---|---|
| uid | number | 會話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
| Param | Type | Description |
|---|---|---|
| roster_id | number | 會話ID |
| mid | number | 訊息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
| Param | Type | Description |
|---|---|---|
| uid | number | 會話ID |
| mid | number | 訊息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
| Param | Type | Description |
|---|---|---|
| uid | number | 會話ID |
| mid | number | 訊息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
| Param | Type | Description |
|---|---|---|
| uid | number | 會話ID |
| mid | number | 訊息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
| Param | Type | Description |
|---|---|---|
| uid | number | 會話ID |
| mid | number | 訊息ID |
| content | string | 訊息追加內容 |
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
| Param | Type | Default | Description |
|---|---|---|---|
| uid | number | 會話ID | |
| mid | number | 訊息ID | |
| content | string | 訊息更新內容 | |
| config | string | object | null | 訊息更新配置 |
| ext | string | object | null | 訊息更新擴展信息 |
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 - 好友信息
| Param | Type | Description |
|---|---|---|
| rid | number | 好友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 - 未讀數
| Param | Type | Description |
|---|---|---|
| uid | number | 會話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>> - 好友申請列表
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.cursor | number | 從哪開始取得:可以傳空字串表示從頭開始取 |
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列表
| Param | Type | Description |
|---|---|---|
| params | object | 參數:空物件 |
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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者ID |
| params.alias | string | 備註 |
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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者ID |
| params.ext | string | 擴展欄位 |
| params.mute_notification | boolean | 是否接收訊息提醒 |
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> - 是否成功
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者ID |
| params.alias | string | 備註名稱 |
| params.mute_notification | boolean | 是否接收訊息提醒 |
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> - 使用者信息
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.username | string | 使用者名 |
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> - 使用者信息
| Param | Type | Description |
|---|---|---|
| params | object | 參數 |
| params.user_id | number | 使用者ID |
Example
{% lanying_code_snippet repo="lanying-im-web",class="rosterManage",function="asyncSearchRosterById" %}{% endlanying_code_snippet %}