apicloud融雲模塊文檔筆記

apicloud融雲模塊文檔筆記

APICloud融雲模塊V2.0.0
方法歸類

• 配置類
• 發送類
• 獲取信息類
• 操作類

---

配置類

-1、 init初始化

var rong = api.require('rongCloud2');

rong.init(function(ret, err){
    if (ret.status == 'error')
        api.toast({ msg: err.code });
});

-2、 setConnectionStatusListener
設置連接狀態變化的監聽器，請在調用 init 方法之後，調用 connect 方法之前設置

var rong = api.require('rongCloud2');

// 之前調用 init 的代碼省略

rong.setConnectionStatusListener(function(ret, err){
    api.toast({ msg: ret.result.connectionStatus });
});

// 之後調用 connect 的代碼省略

-3、 connect
連接融雲 IM 服務器，進行後續各種方法操作前務必要先調用此方法

var rong = api.require('rongCloud2');

// 之前調用 init 的代碼省略

rong.setConnectionStatusListener(function(ret, err){
    api.toast({ msg: ret.result.connectionStatus });
});

rong.connect({
    token: 'ThptTWyiPPPvZHvuSiuri82yq+hfEluLjZ78E1qo4hEVSFQNpqdoPu406urMWKN4Z3/olWR+v9JVLAwfOQoLrA=="},
    function(ret, err){
        if (ret.status == 'success')
            api.toast({ msg: ret.result.userId });
});

-4、 disconnect斷開連接

var rong = api.require('rongCloud2');

// 之前調用 init 的代碼省略

rong.setConnectionStatusListener(function(ret, err){
    api.toast({ msg: ret.result.connectionStatus });
});

rong.connect({
    token: 'ThptTWyiPPPvZHvuSiuri82yq+hfEluLjZ78E1qo4hEVSFQNpqdoPu406urMWKN4Z3/olWR+v9JVLAwfOQoLrA=="},
    function(ret, err){
        if (ret.status == 'success')
            api.toast({ msg: ret.result.userId });
});


 rong.disconnect({
         isReceivePush: true
     },function (ret, err) {
           if ('success' == ret.status) {
               api.toast({msg: '斷開連接成功!'});
           }
       }
 );  // 斷開，且不再接收 Push

• 5、setNotificationQuietHours

設置消息通知免打擾時間

setNotificationQuietHours({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setNotificationQuietHours({
        startTime: '22:00:00',
        spanMinutes: 6

    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 6、removeNotificationQuietHours

移除消息通知免打擾時間

removeNotificationQuietHours(callback(ret, err))

這裏寫代碼片

• 7、setOnReceiveMessageListener
  設置接收消息的監聽器，請在調用 init 方法之後，調用 connect 方法之前設置
  所有接收到的消息、通知、狀態都經由此處設置的監聽器處理。包括私聊消息、討論組消息、羣組消息、聊天室消息以及各種其他消息、通知、狀態等
  setOnReceiveMessageListener(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 的代碼省略

rong.setOnReceiveMessageListener(function (ret, err) {
    api.toast({ msg: JSON.stringify(ret.result.message) });
    api.toast({ msg: ret.result.message.left });
})

// 之後調用 connect 的代碼省略

發送類

• conversationType 會話類型
  區分不同的會話形式，字符串類型
  取值範圍
  
  • PRIVATE // 單聊
  • DISCUSSION // 討論組
  • GROUP // 羣組
  • CHATROOM // 聊天室
  • CUSTOMER_SERVICE // 客服
  • SYSTEM // 系統
• targetId: 接收方ID
• text：消息的文字內容
• voicePath:語音文件的路徑，支持 fs://，如：fs:///voice/123.amr。文件要求爲 AMR 格式
• duration:語音消息的時長，單位爲秒
• imagePath:圖片的路徑，支持 fs://，如：fs:///image/123.jpg
• title:消息的標題
• description:消息的內容描述
• imageUrl:消息圖片的網絡地址
• latitude: 緯度例如-39.9139**直接傳值即可不需要字符串**
• longitude: 經度例如-116.3917**直接傳值即可不需要字符串**
• poi: 位置的名稱例如-‘北京市朝陽區北苑路北辰泰嶽大廈’
• imagePath: 地圖縮率圖的路徑，支持 fs://，如：’fs:///xxx/xxx/location.jpg’,
• extra：消息的附加信息
• name:命令的名稱
• data:命令的數據
-

列表

• 1、 sendTextMessage發送文字消息
  sendTextMessage({params}, callback(ret, err))

var rong = api.require('rongCloud2');

rong.init(function(ret, err){
    if (ret.status == 'error')
        api.toast({ msg: err.code });
});
// 之前調用 init 的代碼省略

rong.setConnectionStatusListener(function(ret, err){
    api.toast({ msg: ret.result.connectionStatus });
});

rong.connect({
    token: 'ThptTWyiPPPvZHvuSiuri82yq+hfEluLjZ78E1qo4hEVSFQNpqdoPu406urMWKN4Z3/olWR+v9JVLAwfOQoLrA=="},
    function(ret, err){
        if (ret.status == 'success')
            api.toast({ msg: ret.result.userId });
});
rong.sendTextMessage({
        conversationType: 'PRIVATE',
        targetId: '9527',
        text: 'Hello world.',
        extra: ''
    }, function (ret, err) {
        if (ret.status == 'prepare')
            api.toast({ msg: JSON.stringify(ret.result.message) });
        else if (ret.status == 'success')
            api.toast({ msg: ret.result.message.messageId });
        else if (ret.status == 'error')
            api.toast({ msg: err.code });
    }
);

• 2、 sendVoiceMessage發送語音消息
  sendVoiceMessage({params}, callback(ret, err))
• 3、 sendImageMessage發送圖片消息
  sendImageMessage({params}, callback(ret, err))
• 4、 sendRichContentMessage發送圖文消息
  sendRichContentMessage({params}, callback(ret, err))
• 5、sendCommandNotificationMessage
  發送命令消息，可以用來實現任何自定義消息的發送（例如添加好友）
  sendCommandNotificationMessage({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.sendCommandNotificationMessage({
        conversationType: 'PRIVATE',
        targetId: '9527',
        name: 'AddFriend',
        data: '{\"inviteUserId\":123}'
    }, function (ret, err) {
        if (ret.status == 'prepare')
            api.toast({ msg: JSON.stringify(ret.result.message) });
        else if (ret.status == 'success')
            api.toast({ msg: ret.result.message.messageId });
        else if (ret.status == 'error')
            api.toast({ msg: err.code });
    }
);

• 6、sendCommandMessage
  發送命令消息，您需要這種類型的消息時可以直接使用，不需要再自定義。此消息不保存、不計數。
  sendCommandMessage({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.sendCommandMessage({
        conversationType: 'PRIVATE',
        targetId: '9527',
        name: 'AddFriend',
        data: '{\"inviteUserId\":123}'
    }, function (ret, err) {
        if (ret.status == 'prepare')
            api.toast({ msg: JSON.stringify(ret.result.message) });
        else if (ret.status == 'success')
            api.toast({ msg: ret.result.message.messageId });
        else if (ret.status == 'error')
            api.toast({ msg: err.code });
    }
);

獲取類

getConnectionStatus

獲取連接狀態

getConnectionStatus(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getConnectionStatus(function (ret, err) {
        api.toast({ msg: ret.result.connectionStatus });
})

logout

註銷登錄(不再接收 Push 消息)

logout(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.logout(function (ret, err) {
        if (ret.status == 'error')
            api.toast({ msg: err.code });
}); // 斷開，且不再接收 Push

• 1、getConversationList獲取會話列表
  會話列表按照時間從前往後排列，如果有置頂會話，則置頂會話在前
  getConversationList(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getConversationList(function (ret, err) {
    api.toast({ msg: JSON.stringify(ret.result) });
})

• 2、getConversation獲取某一會話信息
  getConversation({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getConversation({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: JSON.stringify(ret.result) });
})

• 3、getConversationNotificationStatus獲取某一會話的通知狀態
  getConversationNotificationStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getConversationNotificationStatus({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: ret.result.code });
        else
            api.toast({ msg: err.code });
})

• 4、getLatestMessages獲取某一會話的最新消息記錄
  getLatestMessages({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getLatestMessages({
        conversationType: 'PRIVATE',
        targetId: '9527',
        count: 20
    }, function (ret, err) {
        api.toast({ msg: JSON.stringify(ret.result) });
})

• 5、getHistoryMessages獲取某一會話的歷史消息記錄
  getHistoryMessages({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getHistoryMessages({
        conversationType: 'PRIVATE',
        targetId: '9527',
        oldestMessageId: 688,
        count: 20
    }, function (ret, err) {
        api.toast({ msg: JSON.stringify(ret.result) });
})

• 6、getHistoryMessagesByObjectName按照消息類型獲取歷史消息記錄
  getHistoryMessagesByObjectName({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getHistoryMessagesByObjectName({
        conversationType: 'PRIVATE',
        targetId: '9527',
        objectName: 'RC:TxtMsg',
        oldestMessageId: 688,
        count: 20
    }, function (ret, err) {
        api.toast({ msg: JSON.stringify(ret.result) });
})

• 7、getTotalUnreadCount獲取所有未讀消息數
  getTotalUnreadCount(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getTotalUnreadCount(function (ret, err) {
    api.toast({ msg: ret.result });
})

• 8、getUnreadCount獲取來自某用戶（某會話）的未讀消息數
  getUnreadCount({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getUnreadCount({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: ret.result });
})

• 9、getUnreadCountByConversationTypes
  獲取某（些）會話類型的未讀消息數
  getUnreadCountByConversationTypes({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getUnreadCountByConversationTypes({
        conversationTypes: ['PRIVATE', 'GROUP']
    }, function (ret, err) {
        api.toast({ msg: ret.result });
})

• 10、getTextMessageDraft獲取某一會話的文字消息草稿
  getTextMessageDraft({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getTextMessageDraft({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: ret.result });
})

• 11、getRemoteHistoryMessages
  獲取歷史消息記錄（特別說明：調用此方法需要開啓歷史消息漫遊；當用戶因換設備或重裝app導致本地本地存儲丟失的情況，可用此方法獲取記錄；此方法返回值中messageId均爲0，融雲服務器不會保存此值）
  getRemoteHistoryMessages({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getRemoteHistoryMessages({
        conversationType: 'PRIVATE',
        targetId: '9527',
        dateTime: 1418971531533,
        count: 20
    }, function (ret, err) {
        api.toast({ msg: JSON.stringify(ret.result) });
})

• 12、getBlacklistStatus

獲取某用戶是否在黑名單中

getBlacklistStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getBlacklistStatus({
        userId: '688'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 13、getBlacklist

獲取當前用戶的黑名單列表

getBlacklist(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getBlacklist(function (ret, err) {
        api.toast({ msg: JSON.stringify(ret.result) });
})

• 14、getNotificationQuietHours
  獲取消息通知免打擾時間
  getNotificationQuietHours(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getNotificationQuietHours( function (ret, err) {
        api.toast({ msg:  JSON.stringify(ret.result) });
})

• 15、getCurrentUserId

獲取當前連接用戶的信息

getCurrentUserId(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getCurrentUserId( function (ret, err) {
        api.toast({ msg: ret.result });
})

操作類（發佈命令）

• 1、removeConversation
  從會話列表中移除某一會話，但是不刪除會話內的消息
  如果此會話中有新的消息，該會話將重新在會話列表中顯示，並顯示最近的歷史消息
  removeConversation({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.removeConversation({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 2、clearConversations清空所有會話及會話消息
  clearConversations({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.clearConversations({
        conversationTypes: ['PRIVATE', 'GROUP']
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 3、setConversationToTop設置某一會話爲置頂或者取消置頂
  setConversationToTop({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setConversationToTop({
        conversationType: 'PRIVATE',
        targetId: '9527',
        isTop: true
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 4、setConversationNotificationStatus設置某一會話的通知狀態
  setConversationNotificationStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setConversationNotificationStatus({
        conversationType: 'PRIVATE',
        targetId: '9527',
        notificationStatus: 'DO_NOT_DISTURB'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: ret.result.code });
        else
            api.toast({ msg: err.code });
})

• 5、deleteMessages刪除指定的一條或者一組消息
  deleteMessages({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.deleteMessages({
        messageIds: [688, 689]
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 6、clearMessages清空某一會話的所有聊天消息記錄
  clearMessages({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.clearMessages({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 7、setMessageReceivedStatus設置接收到的消息狀態
  **UNREAD // 未讀
  READ // 已讀
  LISTENED // 已收聽
  DOWNLOADED // 已下載**
  setMessageReceivedStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setMessageReceivedStatus({
        messageId: '688',
        receivedStatus: 'READ'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 8、clearMessagesUnreadStatus清除某一會話的消息未讀狀態
  clearMessagesUnreadStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.clearMessagesUnreadStatus({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 10、setMessageExtra
  設置消息的附加信息，此信息只保存在本地
  setMessageExtra({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setMessageExtra({
        messageId: '688',
        value: 'extra info'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 11、saveTextMessageDraft
  保存某一會話的文字消息草稿
  saveTextMessageDraft({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.saveTextMessageDraft({
        conversationType: 'PRIVATE',
        targetId: '9527',
        content: 'Hello w'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 12、clearTextMessageDraft
  清除某一會話的文字消息草稿
  clearTextMessageDraft({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.clearTextMessageDraft({
        conversationType: 'PRIVATE',
        targetId: '9527'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 13、addToBlacklist
  將某個用戶加到黑名單中
  addToBlacklist({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.removeFromBlacklist({
        userId: '688'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 14、removeFromBlacklist
  將個某用戶從黑名單中移出
  removeFromBlacklist({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.removeFromBlacklist({
        userId: '688'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 15、setMessageSentStatus

設置消息發送狀態

setMessageSentStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setMessageSentStatus({
        messageId: 8,
        sentStatus: 'READ'
    }, function (ret, err) {
        api.toast({ msg: ret.status });
})

• 16、disableLocalNotification

設置本地消息不提示

disableLocalNotification(callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.disableLocalNotification( function (ret, err) {
        api.toast({ msg: ret.status });
})

創建討論組 建羣等相關操作

• 1、createDiscussion創建討論組
  createDiscussion({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.createDiscussion({
        name: 'Ironman, Batman',//討論組名稱，如：當前所有成員的名字的組合。
        userIdList: ['1234', '4321']//討論組成員 Id 列表
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: ret.result.discussionId });
        else
            api.toast({ msg: err.code });
})

返回字段包括創建成功的討論組id
ret返回值

{
    status: 'success', // 狀態碼：success / error
    result: {
        discussionId: "1b9f7abe-a5ae-463d-8ff8-d96deaf40b59" // 創建成功的討論組 Id
    }
}

• 2、getDiscussion

獲取討論組信息和設置

getDiscussion({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.getDiscussion({
        discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.result.discussion) });
        else
            api.toast({ msg: err.code });
})

ret返回值

{
    status: 'success', // 狀態碼：success / error
    result: {
        creatorId: '55', // 討論組創建者 Id
        id: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59', //討論組 Id
        name: 'Ironman, Batman', // 討論組名稱
        memberIdList: [ '1234', '4321' ], // 成員 Id 列表
        inviteStatus: 'OPENED' // 是否公開好友邀請：OPENED / CLOSED，參見 討論組邀請狀態
    }
}

• 3、setDiscussionName

設置討論組名稱

setDiscussionName({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setDiscussionName({
        discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
        name: 'Ironman, Hulk'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 4、addMemberToDiscussion

添加一名或者一組用戶加入討論組

addMemberToDiscussion({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.addMemberToDiscussion({
        discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
        userIdList: ['4567', '7654']
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 5、removeMemberFromDiscussion

供創建者將某用戶移出討論組

移出自己或者調用者非討論組創建者將產生 -1 未知錯誤

removeMemberFromDiscussion({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.removeMemberFromDiscussion({
        discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
        userId: '4567'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 6、quitDiscussion

退出當前用戶所在的某討論組

quitDiscussion({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.quitDiscussion({
        discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 7、setDiscussionInviteStatus

設置討論組成員邀請權限

取值範圍
OPENED // 開放邀請
CLOSED // 關閉邀請
setDiscussionInviteStatus({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.setDiscussionInviteStatus({
        discussionId: '1b9f7abe-a5ae-463d-8ff8-d96deaf40b59',
        inviteStatus: 'OPENED'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 7、syncGroup

同步當前用戶所屬的羣組信息到融雲服務器

syncGroup({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.syncGroup({
        groups: [
            {
                groupId: '123',
                groupName: 'Ski Club',
                portraitUrl: 'http://club.com/ski.jpg'
            }, {
                groupId: '456',
                groupName: 'Diving Club',
                portraitUrl: 'http://club.com/diving.jpg'
            }
        ]
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 8、joinGroup

當前用戶加入某羣組

joinGroup({params}, callback(ret, err))

ong.joinGroup({
        groupId: '123',
        groupName: 'Ski Club'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 9、quitGroup

當前用戶退出某羣組

quitGroup({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.quitGroup({
        groupId: '123'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 10、joinChatRoom

當前用戶加入某聊天室

joinChatRoom({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.joinChatRoom({
        chatRoomId: '123',
        defMessageCount: 20
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})

• 11、quitChatRoom

當前用戶退出某聊天室

quitChatRoom({params}, callback(ret, err))

var rong = api.require('rongCloud2');

// 之前調用 init 和 connect 的代碼省略

rong.quitChatRoom({
        chatRoomId: '123'
    }, function (ret, err) {
        if (ret.status == 'success')
            api.toast({ msg: JSON.stringify(ret.status) });
        else
            api.toast({ msg: err.code });
})