消息韩国服务器租用

韩国服务器租用时间:2020-12-30 阅读:()

即时通信IM版权所有:腾讯云计算(北京)有限责任公司第1共70页即时通信IM产品简介产品文档即时通信IM版权所有:腾讯云计算(北京)有限责任公司第2共70页【版权声明】2013-2020腾讯云版权所有本文档(含所有文字、数据、图片等内容)完整的著作权归腾讯云计算(北京)有限责任公司单独所有,未经腾讯云事先明确书面许可,任何主体不得以任何形式复制、修改、使用、抄袭、传播本文档全部或部分内容.
前述行为构成对腾讯云著作权的侵犯,腾讯云将依法采取措施追究法律责任.
【商标声明】及其它腾讯云服务相关的商标均为腾讯云计算(北京)有限责任公司及其关联公司所有.
本文档涉及的第三方主体的商标,依法由权利人所有.
未经腾讯云及有关权利人书面许可,任何主体不得以任何方式对前述商标进行使用、复制、修改、传播、抄录等行为,否则将构成对腾讯云及有关权利人商标权的侵犯,腾讯云将依法采取措施追究法律责任.

【服务声明】本文档意在向您介绍腾讯云全部或部分产品、服务的当时的相关概况,部分产品、服务的内容可能不时有所调整.

您所购买的腾讯云产品、服务的种类、服务标准等应由您与腾讯云之间的商业合同约定,除非双方另有约定,否则,腾讯云对本文档内容不做任何明示或默示的承诺或保证.
【联系我们】我们致力于为您提供个性化的售前购买咨询服务,及相应的技术售后服务,任何问题请联系4009100100.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第3共70页文档目录产品简介产品概述应用场景功能介绍帐号系统登录鉴权在线状态管理用户资料与关系链资料管理关系链管理消息管理单聊消息消息存储离线推送群组消息消息格式描述群组系统群组系统群组管理使用限制即时通信IM版权所有:腾讯云计算(北京)有限责任公司第4共70页简介腾讯是国内最早也是最大的即时通信开发商,QQ和微信已经成为每个互联网用户必不可少的应用.
顺应行业数字化转型的趋势,腾讯将高并发、高可靠的即时通信能力进行开放,您可以轻易地根据腾讯提供的SDK将即时通信功能集成到App中,来满足您业务的各种需求.
针对开发者的不同阶段需求及不同场景,即时通信IM团队提供了一系列解决方案,包括:Android、iOS、Windows、Web的SDK组件、服务端集成RESTAPI接口、第三方回调接口等.
利用这些组件和能力,开发者可以简单快捷地构建高可靠且稳定的即时通信产品,随心所想,触达全球.
架构介绍即时通信IM提供全球接入、单聊、群聊、消息推送、资料关系链托管、帐号鉴权等全方位解决方案,并提供完备的App接入、后台管理接口.
业务介绍接入服务接入服务为即时通信IM提供覆盖全球的高连通、高可靠、强安全的网络连接通道,自研多重最优寻址算法,具有全网调度能力,使用智能兼容技术穿透网关策略,长连接多路复用,传输层协议优化,通道加密等,让业务不必关心网络细节,即可安全地产品简介产品概述最近更新时间:2020-10-1310:32:20即时通信IM版权所有:腾讯云计算(北京)有限责任公司第5共70页与业务后台实现简单可靠的通讯.
终端登录时,IMSDK会访问就近接入点或加速点.
全球接入加速点分布如下:中国:华南、华北、华东、香港等.
其他国家(或地区):亚洲:新加坡、印度尼西亚、阿联酋、泰国、日本、越南、印度等.
欧洲:英国、荷兰、德国、意大利、挪威、法国、俄罗斯等.
南美洲:巴西等.
北美洲:美国、加拿大、墨西哥等.
大洋洲:澳大利亚等.
非洲:南非等.
单聊单聊即1V1聊天,提供包括文字、表情、地理位置、图片、语音、短视频及自定义消息的能力,可实现红包、对话机器人、消息回执、消息撤回等特殊功能,除此之外还提供离线消息、漫游消息等服务.
详细可参阅单聊消息文档.
群聊多人聊天服务,根据群组加群方式及管理组织形式的部分预设以下四种群组类型,可以适应各种群聊场景需求.

好友工作群(Work):类似普通微信群,创建后仅支持已在群内的好友邀请加群,且无需被邀请方同意或群主审批.

陌生人社交群(Public):类似QQ群,创建后群主可以指定群管理员,用户搜索群ID发起加群申请后,需要群主或管理员审批通过才能入群.
临时会议群(Meeting):创建后可以随意进出,且支持查看入群前消息;适合用于音视频会议场景、在线教育场景等与实时音视频产品结合的场景.
直播群(AVChatRoom):创建后可以随意进出,没有群成员数量上限,但不支持历史消息存储;适合与直播产品结合,用于弹幕聊天场景.
群组具备高度可定制性,包括自定义群组类型、自定义群组字段、自定义群成员字段、自定义群组ID、自定义事件回调等.
App可以根据自己的需求进行深度定制.
详细可参阅群组系统文档.
资料关系链托管提供资料、关系链托管的一套整体解决方案,可存储用户的资料(例如昵称、头像、自定义资料字段)、好友列表、黑名单等.

即时通信IM资料关系链托管服务提供高达12份的备份服务,多机房异地部署,提高服务质量及容灾效果.
详细可参阅资料管理、关系链管理文档.
帐号鉴权提供安全的非对称加密ECDSA-SHA256和哈希加密HMAC-SHA256(推荐使用HMAC-SHA256),开发者可直接使用App自有帐号快速集成即时通信IM服务,省去帐号映射的繁琐工作.
通过简单的SDK集成,便捷的接口调用,完成用户帐注意:直播群(AVChatRoom)不设成员人数上限,但如果预期群成员会出现短时间内激增的场景(例如举行大型在线活动,单群成员人数达到5万或以上等情况),请提前联系腾讯云客服或商务工作人员,提供SDKAppID和活动预期发生时间进行服务资源报备.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第6共70页号(UserID)与密码(UserSig)的鉴权.
详细可参阅登录鉴权文档.
管理与监控除了基础的即时通信功能之外,即时通信IM还提供了方便且易用的管理控制台.
您可通过控制台完成应用创建,下载即时通信IMSDK,查询应用配置信息完成应用联调,集成即时通信功能;同时,控制台还为您提供了后台消息下发、群组管理和数据统计等功能.
详细可参阅控制台指南文档.
高级功能RESTAPIRESTAPI是一个HTTP管理接口,主要功能是为App后台提供一个后台管理入口.
目前即时通信IM支持的RESTAPI参阅RESTAPI接口简介文档.
除了RESTAPI,即时通信IM控制台也可实现简单的数据管理、单发/群发消息等功能,开发者可以在即时通信IM控制台进行数据管理、查看及测试.
相比之下,RESTAPI接口较为原始,但可以提供功能更为强大的管理能力.
第三方回调所谓第三方回调,即即时通信IM会在某一事件发生之前或者之后,向App的后台服务器发送请求,App后台可以据此进行必要的数据同步,或者干预事件的后续处理流程.
即时通信IM提供种类丰富的回调接口,目前回调功能完全免费.
详细请参阅回调命令列表文档.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第7共70页社交沟通即时通信IM为应用于社交沟通提供能力支持,可实现单聊、群聊、弹幕等多种聊天模式,支持文字、图片、语音、短视频等多种消息类型,实时消息推送满足消息到达率的要求,并可支持实时音视频通话,有效提升用户粘性与活跃度.

示例场景:应用内聊天推荐功能:消息管理、群组管理客户案例:QQ、微信互动直播即时通信IM提供直播聊天室互动能力,聊天室无人数上限,支持亿级消息并发,轻松实现弹幕、送礼和点赞等多消息类型,管理灵活,轻松打造良好的直播聊天互动体验;提供弹幕内容审核能力,保证您的直播免受违法、违规文字信息的干扰.

示例场景:直播推荐功能:直播群客户案例:斗鱼、NOW直播智能客服即时通信IM满足商家与用户多场景沟通的需要,为客户提供专属客服服务,提升服务效率,与智能机器人相结合,可有效降低人力成本,沉淀客户价值.
示例场景:线上商城客服推荐功能:在线客服客户案例:阳光约车物联网通信即时通信IM提供人与物,物与物协同通信,携手共进引领5G通信时代潮流.
示例场景:智能设备与App端通信推荐功能:语音、图片、视频消息客户案例:优必选机器人企业通讯即时通信IM为企业客户提供解决方案,可覆盖桌面和移动端,设备无缝切换,实现企业沟通和办公的高效协同.

示例场景:企业内部通信推荐功能:即时通信客户案例:百世快递系统消息通知即时通信IM提供在线推送与离线推送服务,让系统消息精准到达.
示例场景:App系统通知推荐功能:消息推送客户案例:货拉拉应用场景最近更新时间:2020-07-2416:27:07即时通信IM版权所有:腾讯云计算(北京)有限责任公司第8共70页游戏交流即时通信IM可为游戏客户端提供大厅、小队、全服等多种聊天室类型,支持文字、语音、表情、短视频等多种消息类型,可通过自定义消息轻松实现游戏内道具赠送、交易等业务场景;同时,即时通信IM支持全球业务,我们已经在海外数十个国家部署专用服务器,为您的即时通信全球化提供强大动力.
示例场景:大厅群聊推荐功能:多种群组类型、全球接入客户案例:王者荣耀助手、腾讯游戏助手即时通信IM版权所有:腾讯云计算(北京)有限责任公司第9共70页平台支持以下平台都支持互通,且能跨终端全平台服务.
平台SDK及兼容性Demo源码UI组件Android兼容支持JDK1.
6和AndroidSDKversion14以上系统支持支持支持iOS兼容iOS8.
0以上版本支持支持支持Mac兼容OSX10.
10以上版本支持支持-Windows包含C、C++,兼容Windows7、Windows8/8.
1、Windows10;全面支持32位和64位程序接入---Web支持IE9+,Chrome7+,FireFox3.
6+,Opera12+和Safari6+支持--小程序支持支持--全球接入功能类型功能描述全球接入简介即时通信IM提供覆盖全球的高连通、高可靠、强安全的网络连接通道,自研多重最优寻址算法,具有全网调度能力,终端在海外登录时,IMSDK会访问就近接入点或加速点中国华南、华北、华东、香港、台湾等海外亚洲:日本、韩国、新加坡、印度、泰国、马来西亚、越南、菲律宾、阿联酋欧洲:德国、英国、法国、俄罗斯、意大利、挪威、西班牙北美洲:美国、加拿大、墨西哥南美洲:巴西大洋洲:澳大利亚非洲:南非等帐号功能功能类型功能描述帐号导入批量导入帐号帐号禁用UserSig失效帐号删除批量删除帐号用户在线状态管理在线和离线状态(以用户登录为前提)功能介绍最近更新时间:2020-12-0811:24:01即时通信IM版权所有:腾讯云计算(北京)有限责任公司第10共70页多端登录功能类型功能描述单端登录仅允许Windows、Web、Android或iOS单端登录双端登录(默认状态)允许Windows、Android或iOS单端登录,同时允许与Web端同时在线三端登录允许Android或iOS单端登录,同时允许与Windows和Web端同时在线多端同时在线允许Windows、Web、Android或iOS多端或全端同时在线登录消息类型功能类型功能描述文本消息消息内容是普通文本图片消息消息内容为图片URL地址、尺寸、图片大小等信息表情消息表情消息为开发者自定义语音消息语音数据需要提供时长信息,以秒为单位地理位置消息消息内容为地理位置标题、经度、纬度信息文件消息消息内容为文件的URL地址、大小、格式等信息,格式不限,最大支持100M短视频消息消息内容为视频文件的URL地址、时长、大小、格式等信息,最大支持100M自定义消息开发者自定义的消息类型,例如红包消息、石头剪刀布等形式的消息系统通知消息包含内置的系统通知消息和开发者自定义系统通知消息消息功能功能类型功能描述消息下载App管理员可以通过该接口获取App中某天某小时的所有单发或群组消息记录离线消息用户登录后退到后台,当有用户给其发消息时,即时通信IM支持离线推送漫游消息在新设备登录时,将服务器记录(云端)的历史消息存储进行同步,默认保存7天,可付费延长多端同步多终端消息同步,可同时收到消息历史消息支持本地历史消息和云端历史消息说明:您可以登录即时通信IM控制台,单击目标应用所在行的【应用配置】,在【功能配置】页配置多端登录.

即时通信IM版权所有:腾讯云计算(北京)有限责任公司第11共70页功能类型功能描述消息撤回撤回投递成功的消息,默认撤回2分钟内的消息.
撤回操作仅支持单聊和群聊消息,不支持直播群(AVChatRoom)的撤回已读回执查看点对点会话中对方的已读未读状态消息转发将消息转发给其他用户或群组@功能群内@消息与普通消息没有本质区别,仅是在被@的人在收到消息时,需要在UI上做特殊处理正在输入可以通过在线消息实现离线推送支持苹果APNs、小米推送、华为推送、魅族推送、OPPO推送、vivo推送、GoogleFCM推送消息删除使用消息的remove方法可以在本地删除消息红包功能红包消息与@消息类似,可以通过TIMCustomElem来实现资料功能功能类型功能描述设置用户资料用户设置自己的昵称、验证方式、头像、性别、年龄、签名、位置等资料获取用户资料用户查看自己、好友及陌生人资料按字段获取用户资料按照特定字段获取用户资料自定义用户资料最大20个自定义用户资料字段关系链功能功能类型功能描述查找好友可通过用户帐号ID查找好友申请添加好友要选择默认是否需要申请理由,目前是默认不需要添加好友发送添加好友请求删除好友成为好友后可以删除好友获取所有好友获取所有好友,默认只拉取基本资料同意/拒绝好友收到请求加好友请求的系统通知后,可以通过或者拒绝添加用户到黑名单把任意用户拉黑,如果此前是好友关系会解除好友关系移除黑名单把用户从黑名单中移除获取黑名单列表拉取用户黑名单列表即时通信IM版权所有:腾讯云计算(北京)有限责任公司第12共70页功能类型功能描述好友备注成为好友后可以给好友备注设置好友自定义资料最多20个好友自定义字段创建好友分组创建分组时,可以同时指定添加的用户,同一用户可以添加到多个分组删除好友分组删除好友分组添加好友到某分组将好友添加到好友分组从某分组删除好友将好友从好友分组中删除重命名好友分组重命名好友分组获取指定好友分组信息获取指定的好友分组获取所有好友分组获取所有分组信息,另外,通过获取所有好友也可以获取分组信息关系链资料存储SDK可以对关系链资料进行存储好友资料变更系统通知好友资料变更可以收到系统通知关系链变更系统通知关系链变更可以收到系统通知群组功能即时通信IM根据常见使用场景,默认配置了以下群组类型:好友工作群(Work):类似普通微信群,创建后仅支持已在群内的好友邀请加群,且无需被邀请方同意或群主审批;陌生人社交群(Public):类似QQ群,创建后群主可以指定群管理员,用户搜索群ID发起加群申请后,需要群主或管理员审批通过才能入群;临时会议群(Meeting):创建后可以随意进出,且支持查看入群前消息;适合用于音视频会议场景、在线教育场景等与实时音视频产品结合的场景;直播群(AVChatRoom):创建后可以随意进出,没有群成员数量上限,但不支持历史消息存储;适合与直播产品结合,用于弹幕聊天场景.
每个群组类型的默认功能差异如下表示意:功能类型好友工作群(Work)陌生人交友群(Public)临时会议群(Meeting)直播群(AVChatRoom)最高支持成员数量上限6000人6000人6000人无上限即时通信IM版权所有:腾讯云计算(北京)有限责任公司第13共70页功能类型好友工作群(Work)陌生人交友群(Public)临时会议群(Meeting)直播群(AVChatRoom)可获取成员资料限制全部可见全部可见全部可见仅展示前300个加群的成员是否支持设置管理员不支持支持支持不支持群资料修改权限任意群成员均可修改后台App管理员群主群管理员后台App管理员群主群管理员后台App管理员群主后台App管理员解散群组权限后台App管理员群主后台App管理员群主后台App管理员群主后台App管理员是否支持群主退群支持不支持不支持不支持是否支持申请加群不支持支持,但需要群主或管理员审批支持,且无需审批支持,且无需审批是否支持成员邀请他人加群支持不支持不支持不支持"踢人"权限群主后台App管理员群主群管理员后台App管理员群主群管理员后台App管理员不支持踢人,可用"禁言"功能达到类似效果"禁言"权限不支持禁言群主群管理员(仅支持禁言普通群成员)后台App管理员群主群管理员(仅支持禁言普通群成员)后台App管理员群主后台App管理员是否支持查看入群前历史消息不支持不支持支持不支持成员变更通知(进群/退群等)全员全员无全员是否需要在创建群组后发消息激活需要不需要不需要不需要是否支持未读消息计数支持支持不支持不支持是否支持导入群(群成员/基础资料等)支持支持支持不支持即时通信IM版权所有:腾讯云计算(北京)有限责任公司第14共70页即时通信IM控制台您可以在腾讯云即时通信IM控制台根据您的需求对您的应用进行配置.
功能类型功能描述创建应用新建应用下载SDK下载客户端的SDK应用配置可进行应用配置统计分析运营数据查看查看Crash错误上报回调配置第三方回调功能配置增加自定义字段和在线实例开发者辅助工具在网页端生成UserSig数据统计即时通信IM控制台的统计分析功能有各类维度的数据统计,为您提供运营数据.
统计类型功能描述活跃用户数与服务器产生连接交互的去重用户数新增注册数新增注册ID数量累计注册数查看所有注册用户数上行消息数可以选择时间查看上行消息数发送消息人数可以选择时间查看发送消息人数最高同时在线人数可以选择时间查看在线同时在线人数单聊上行消息数可以选择时间查看单聊上行消息数单聊发消息人数可以选择时间查看单聊发消息人数群聊上行消息数可以选择时间查看群组中上行消息数群聊发消息人数可以选择时间查看群组中发消息的人数发消息群组数可以选择时间查看发消息群组数新增群组数可以选择时间查看新增群组数累计群组数可以选择时间查看累计群组数导出数据可以选择时间导出数据即时通信IM版权所有:腾讯云计算(北京)有限责任公司第15共70页统计类型功能描述即时通信IM版权所有:腾讯云计算(北京)有限责任公司第16共70页登录鉴权简介即时通信IM的前身是QQ的即时通信系统,我们抽离QQ的通用模块,并将其整合成适合终端接入的IMSDK及后台服务.
您可以把IMSDK理解为一个没有用户交互界面的QQ,把IMSDK集成到您的App里,就相当于把一个QQ的内核集成在您的App内部.
QQ可以用来收发消息,但前提是您必须先登录才能使用.
登录QQ用的是QQ号和密码,登录IMSDK需要使用您指定的用户名(UserID)和密码(UserSig).
UserID:旧称为Identifier,用户登录即时通信IM时使用的用户名,即您App里的用户ID.
例如,App里有一个用户,该用户的ID是27149,那么您可以用27149作为登录即时通信IM的UserID.
UserSig:用户登录即时通信IM时使用的密码,其本质是AppServer用密钥对UserID等信息加密后的数据.
具体生成方法请参见生成UserSig.
App登录流程推荐的App登录即时通信IM流程如下:帐号系统登录鉴权最近更新时间:2020-12-2211:36:41注意:即时通信IM后台完全信赖UserSig,为避免数据和业务受影响,请务必确保私钥的安全.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第17共70页App管理员即时通信IM的部分服务需要管理员权限,例如调用RESTAPI接口、解散群以及全员推送等.
App管理员是对App具有最高管理权限的角色,与普通帐号相比,其区别如下:读取权限更高.
例如,获取App内部的所有群组、获取任意群组的任意资料.
操作权限更高.
例如,给任意用户发消息、在任意群组中增删成员.
设置App管理员仅能通过登录控制台操作,具体操作请参见配置帐号管理员.
即时通信IM后台SDK默认接口生成的UserSig有效期为180天,可以使用含有效期参数的接口自行设定有效期,开发者需要在UserSig过期前到开发者后台获取新的UserSig.
用于生成UserSig的即时通信IM后台SDK详细请参阅生成UserSig.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第18共70页概念介绍每个用户的状态类型有以下三种:前台运行状态(Online)后台运行状态(PushOnline)未登录状态(Offline)前台运行状态(Online)前台运行状态(Online),是指客户端和即时通信IM服务端保持有顺畅的TCP网络连接,客户端可以发消息给即时通信IM服务端,也可以收到来自即时通信IM服务端推送的消息.
当用户打开App后,状态即为前台运行状态(Online).
App启动后,客户端和即时通信IM服务端建立TCP长连接,即时通信IM服务端保存客户端的在线信息,例如客户端的网络链路信息,客户端的平台版本等.
App在运行过程中,IMSDK会定时发送心跳来确认用户的在线状态.
后台运行状态(PushOnline)后台运行状态(PushOnline),是指客户端和即时通信IM服务端的TCP长连接断开.
此时可收到消息的离线推送.
以下场景用户的状态为后台运行状态(PushOnline):用户使用完App,把App切后台后进程被手机操作系统kill掉,或者用户主动kill掉App进程.
如果App在手机操作系统的保活白名单中,用户把App切后台,进程并不会被手机操作系统kill掉.
此时状态仍然为前台运行状态(Online).
前台运行状态(Online)和后台运行状态(PushOnline)判断的标准之一是App进程是否被kill,即客户端和即时通信IM服务端的TCP长连接是否断开.
用户主动关闭客户端网络(例如打开手机飞行模式),或者客户端网络完全不可用(例如进入完全没有网络信号的隧道).

在这种特殊情况下,客户端连TCP协议的FIN包或RST包都无法发出,即时通信IM服务端需要等待400秒后发现心跳包超时,状态才会变成后台运行状态(PushOnline).
在线状态管理最近更新时间:2020-12-1610:47:20注意:后台运行状态(PushOnline)只有手机端(Android/iOS)会存在,PC、小程序和Web端不存在该种状态.
说明:心跳:IMSDK每隔2分钟发一个心跳包给服务器,以确认用户的在线状态.
注意:后台运行状态(PushOnline)只有手机端(Android/iOS)会存在,PC、小程序和Web端不存在该种状态.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第19共70页未登录状态(Offline)未登录状态(Offline),是指用户没有输入帐号和密码登录前的状态,此时无法收到消息的在线推送,也无法收到消息的离线推送.
以下场景用户的状态为未登录状态(Offline):用户主动登出,或下载App后还未进行过登录时.
用户状态变成后台运行状态(PushOnline)后,7天内没有再登录过,此时状态变为未登录状态(Offline).

查询用户在线状态App后台可以通过RESTAPI:获取用户在线状态来查询一批用户的在线状态.
IMSDK暂时无法获取用户的在线状态.
用户在线状态变更通知即时通信IM可以把用户上下线的事件通知给App后台,参见状态变更回调文档.
状态变更感知的实时性Android/iOS/PC对于绝大多数情况,用户状态的变化都能实时感知,例如:用户主动登录,状态变成前台运行状态(Online).
用户主动登出,状态变成未登录状态(Offline).
用户主动kill客户端进程,或者用户切后台后,客户端进程被手机操作系统kill掉,状态变成后台运行状态(PushOnline).
只有以下一种特殊情况,IM云服务器需要等待400秒的心跳超时时间才能感知状态变更:当网络完全不可用时,客户端连TCP协议层的FIN包或RST包都无法发出时,IM云服务器需要等待400秒的心跳超时时间才能感知到状态变成后台运行状态(PushOnline).
常见的场景有用户主动关闭客户端的网络(例如开启手机的飞行模式),或者进入完全没有网络信号的隧道.
Web用户主动登录Web端时,IM云服务器可以实时感知到状态变成前台运行状态(Online).
用户网络不可用,或者直接关闭Web页面时,IM云服务器需要等待400秒的心跳超时时间才能感知到状态变成未登录状态(Offline).
多端登录互踢默认情况,IMSDK在同时登录多个终端(如同时登录PC、Android)时,会进行互踢,只有最后一个登录的设备可以在线,之前登录的都会被踢下线,详细互踢逻辑可以参考以下文档:Android用户状态变更即时通信IM版权所有:腾讯云计算(北京)有限责任公司第20共70页iOS用户状态变更同时在线即时通信IM支持在控制台修改同时在线策略,通过配置可以做到PC端和手机端同时在线,或者PC、iOS和Android都可以同时在线.
开启同时在线登录不同终端后不会互踢,但是两个相同终端(例如两个iOS端登录)仍然会互踢.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第21共70页资料系统简介即时通信IM开放了用户资料托管能力,提供资料相关的一整套完整解决方案.
如果您想让每个用户都有自己的资料,并且轻松实现资料的设置和拉取功能,那么您可以选择即时通信IM的资料托管服务:即时通信IM提供资料的存储能力,确保您的数据具备异地容灾、多地部署和自动扩容/缩容的能力,帮助您从服务器宕机、多拷贝主从复制和扩容缩容等复杂处理流程中得到完全地解放.
即时通信IM提供业界通用的业务处理流程,帮助您在用户资料的业务逻辑上彻底地解放.

即时通信IM提供专业的运营流程和运营团队,全年99.
99%的稳定服务质量,帮助您为用户提供具有稳定口碑的服务.

即时通信IM提供简单易用的服务接口和快捷接入的帮助指引,全程为您提供星级服务.

使用即时通信IM的资料托管服务,可以得到以下能力:标配资料字段的存储、读写能力.
自定义资料字段的存储、读写能力.
资料字段资料是用来描述用户属性的一组数据,即时通信IM资料系统支持标配资料字段和自定义资料字段.
资料字段有如下特性:资料字段通过Key-Value来表示.
Key为String类型,其命名仅支持英文大小写字母、数字、下划线.
Value有以下几种类型:a.
uint32_t类型的整数(自定义资料字段不支持).
b.
uint64_t类型的整数(自定义资料字段不支持).
c.
string类型的字符串(string的长度不得超过500字节).
d.
bytes类型的一段buffer(buffer的长度不得超过500字节).
支持配置每个Key的读权限和写权限,资料字段的读写权限如下:权限名称权限类型备注读权限App可读App管理员可读可选择读权限的一个或多个类型写权限App可写App管理员可写可选择写权限的一个或多个类型用户资料与关系链资料管理最近更新时间:2020-12-1016:39:39即时通信IM版权所有:腾讯云计算(北京)有限责任公司第22共70页标配资料字段目前即时通信IM支持的标配资料字段如下:字段名称类型描述更新时有Push备注Tag_Profile_IM_Nickstring昵称有长度不得超过500个字节Tag_Profile_IM_Genderstring性别有Gender_Type_Unknown:没设置性别Gender_Type_Female:女性Gender_Type_Male:男性Tag_Profile_IM_BirthDayuint32生日有推荐用法:20190419Tag_Profile_IM_Locationstring所在地有长度不得超过16个字节,推荐用法如下:App本地定义一套数字到地名的映射关系后台实际保存的是4个uint32_t类型的数字其中第一个uint32_t表示国家第二个uint32_t用于表示省份第三个uint32_t用于表示城市第四个uint32_t用于表示区县Tag_Profile_IM_SelfSignaturestring个性签名有长度不得超过500个字节Tag_Profile_IM_AllowTypestring加好友验证方式有AllowType_Type_NeedConfirm:需要经过自己确认对方才能添加自己为好友AllowType_Type_AllowAny:允许任何人添加自己为好友AllowType_Type_DenyAny:不允许任何人添加自己为好友Tag_Profile_IM_Languageuint32语言有无Tag_Profile_IM_Imagestring头像URL有长度不得超过500个字节Tag_Profile_IM_MsgSettingsuint32消息设置有标志位:Bit0:置0表示接收消息,置1则不接收消息Tag_Profile_IM_AdminForbidTypestring管理员禁止加好友标识有AdminForbid_Type_None:默认值,允许加好友AdminForbid_Type_SendOut:禁止该用户发起加好友请求Tag_Profile_IM_Leveluint32等级有通常一个UINT-8数据即可保存一个等即时通信IM版权所有:腾讯云计算(北京)有限责任公司第23共70页级信息您可以考虑拆分保存,从而实现多种角色的等级信息Tag_Profile_IM_Roleuint32角色有通常一个UINT-8数据即可保存一个角色信息您可以考虑拆分保存,从而保存多种角色信息自定义资料字段自定义资料字段是各App根据各自业务需要而设置的用户数据.
通过自定义资料,各App可以将一些额外数据附加到用户资料上,并通过现有接口进行读写操作.
自定义资料字段的申请App管理员可以通过即时通信IM控制台>【应用配置】>【功能配置】申请自定义资料字段,申请提交后,自定义资料字段将在5分钟内生效.
申请自定义资料字段时,需要为每一个自定义资料字段提交如下资料:自定义资料字段的名称(Key):详情可参见自定义资料字段的命名规范自定义资料字段的类型(Value):详情可参见资料字段自定义资料字段的读权限及写权限:详情可参见资料字段自定义资料字段的命名规范自定义资料字段的命名规则如下:自定义资料字段的名称包括前缀和关键字两部分.
自定义资料字段的前缀是:Tag_Profile_Custom.
关键字:必须是英文字母,且长度不得超过8字节,建议用一个英文单词或该英文单词的缩写.

示例:某App要申请的自定义字段的关键字是Test,则自定义资料字段的名称是:Tag_Profile_Custom_Test.
相关文档用户资料与关系链(Android)用户资料与关系链(iOS)用户资料(Web&小程序)即时通信IM版权所有:腾讯云计算(北京)有限责任公司第24共70页关系链系统简介即时通信IM开放了用户关系链托管能力,提供关系链相关的一整套完整解决方案.
如果您不希望自行开发或维护App内用户之间的好友关系,并且轻松玩转加删好友等一系列功能,那么您可以选择即时通信IM的关系链托管服务:即时通信IM提供关系链的存储能力,并确保您的数据具备异地容灾、多地部署和自动扩容缩容的能力,帮助您从服务器宕机、多拷贝主从复制和扩容缩容等复杂处理流程中得到完全地解放.
即时通信IM提供业界通用的业务处理流程,帮助您在用户关系链的逻辑上彻底地解放.

即时通信IM提供专业的运营流程和运营团队,全年99.
99%的稳定服务质量,帮助您为用户提供具有稳定口碑的服务.
即时通信IM提供简单易用的服务接口和快捷接入的帮助指引,全程为您提供星级服务.

关系链是一组用于描述用户和其他用户关系的数据,即时通信IM目前支持的关系链有好友表和黑名单两种.
关系链字段即时通信IM关系链系统支持标配关系链字段和自定义关系链字段,关系链字段有如下特性:关系链字段通过Key-Value形式表示.
Key为String类型,其命名仅支持英文大小写字母、数字、下划线.
Value有以下几种类型:a.
uint64_t类型的整数(自定义关系链字段不支持).
b.
string类型的字符串(string的长度不得超过500字节).
c.
bytes类型的一段buffer(buffer的长度不得超过500字节).
d.
string类型的字符串数组(每个string的长度都不得超过500字节,仅供好友表的Tag_SNS_IM_Group字段使用).
好友表即时通信IM的好友列表最多允许添加3000个好友.
好友表支持标配好友字段和自定义好友字段.
标配好友字段目前即时通信IM支持的标配好友字段如下:字段名称类型描述Tag_SNS_IM_GroupArray好友分组:1.
最多支持32个分组;2.
不允许分组名为空;3.
分组名长度不得超过30个字节;4.
同一个好友可以有多个不同的分组关系链管理最近更新时间:2020-12-2212:46:57即时通信IM版权所有:腾讯云计算(北京)有限责任公司第25共70页字段名称类型描述Tag_SNS_IM_Remarkstring好友备注:1.
备注长度最长不得超过96个字节Tag_SNS_IM_AddSourcestring加好友来源:1.
加好友来源字段包含前缀和关键字两部分;2.
加好友来源字段的前缀是:AddSource_Type_;3.
关键字:必须是英文字母,且长度不得超过8字节,建议用一个英文单词或该英文单词的缩写;4.
示例:加好友来源的关键字是Android,则加好友来源字段是:AddSource_Type_AndroidTag_SNS_IM_AddWordingstring加好友附言:1.
加好友附言的长度最长不得超过256个字节自定义好友字段自定义好友字段是各App根据各自业务需要而设置的好友数据.
通过自定义好友字段,各App可以将一些额外数据附加到好友上,并通过现有的接口进行读写操作.
App管理员可以通过即时通信IM控制台>【应用配置】>【功能配置】申请自定义好友字段,申请提交后,自定义好友字段将在5分钟内生效.
自定义好友字段的命名规则如下:自定义好友字段的名称分为以下两部分:前缀、关键字.
自定义好友字段的前缀是:Tag_SNS_Custom.
关键字:必须是英文字母,且长度不得超过8字节,建议用一个英文单词或该英文单词的缩写.
示例:某App要申请的自定义好友字段的关键字是Test,则自定义关系字段的名称是:Tag_SNS_Custom_Test.
申请自定义好友字段时,需要为每一个自定义好友字段提交如下资料:自定义好友字段的名称(Key).
自定义好友字段的类型(Value):详情可参见关系链字段.
添加好友即时通信IM支持的加好友模式有:批量加好友、一回合加好友和两回合加好友,详情可参见添加好友.
双向好友:用户A的好友表中有用户B,B的好友表中也有A.
单向好友:用户A的好友表中有用户B,但B的好友表中却没有A.
加好友验证方式:每个用户都可以选择自己以哪种方式被其他用户添加为好友,详情可参见标配资料字段中的加好友验证方式字段.
一回合加好友:如果帐号A设置的加好友验证方式是AllowType_Type_AllowAny,那么任何人添加A为好友都可以直接添加成功,这种一个请求就添加好友成功的场景称作一回合加好友.
两回合加好友:如果帐号A设置的加好友验证方式是AllowType_Type_NeedConfirm,那么任何人添加A,A都会收到一个请求加好友验证消息,这是第一个回合,然后A对这个请求加好友验证消息进行同意操作时,这是第二个回合,这种需要验证的加好友场景就被称为两回合加好友.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第26共70页删除好友即时通信IM支持单向删除好友和双向删除好友等两种好友删除模式.
删除模式DeleteType描述单向删除好友Delete_Type_Single只将To_Account从From_Account的好友表中删除,但不会将From_Account从To_Account的好友表中删除双向删除好友Delete_Type_Both将To_Account从From_Account的好友表中删除,同时将From_Account从To_Account的好友表中删除即时通信IM也支持批量删除好友,更多信息可参见删除好友.
拉取好友即时通信IM支持以下三种拉好友模式:不带好友的增量拉取模式、全量分页拉取模式以及带好友拉取模式.
详情可参见拉取好友.
校验好友即时通信IM支持以下两种好友校验模式:单向校验好友关系、双向校验好友关系.
校验模式CheckType描述单向校验好友关系CheckResult_Type_Single只会检查From_Account的好友表中是否有To_Account,不会检查To_Account的好友表中是否有From_Account双向校验好友关系CheckResult_Type_Both既会检查From_Account的好友表中是否有To_Account,也会检查To_Account的好友表中是否有From_Account单向校验好友关系时可能的结果有:Relation描述CheckResult_Type_NoRelationFrom_Account的好友表中没有To_Account,但无法确定To_Account的好友表中是否有From_AccountCheckResult_Type_AWithBFrom_Account的好友表中有To_Account,但无法确定To_Account的好友表中是否有From_Account双向校验好友关系时可能的结果有:Relation描述CheckResult_Type_BothWayFrom_Account的好友表中有To_Account,To_Account的好友表中也有From_AccountCheckResult_Type_AWithBFrom_Account的好友表中有To_Account,但To_Account的好友表中没有From_Account即时通信IM版权所有:腾讯云计算(北京)有限责任公司第27共70页Relation描述CheckResult_Type_BWithAFrom_Account的好友表中没有To_Account,但To_Account的好友表中有From_AccountCheckResult_Type_NoRelationFrom_Account的好友表中没有To_Account,To_Account的好友表中也没有From_Account校验好友的其他相关信息可参见校验好友.
黑名单每个用户都有一份黑名单,用于保存被该用户屏蔽的帐号.
用户A将用户B加入黑名单后,A与B之间的好友关系会被解除(如果有),且A与B之间无法再发起加好友请求.

即时通信IM的黑名单列表默认允许添加1000条黑名单帐号,如对黑名单列表的大小有特殊要求,请联系腾讯云客服.
添加黑名单即时通信IM支持批量添加黑名单,详情可参见:添加黑名单.
删除黑名单即时通信IM支持批量删除黑名单,详情可参见:删除黑名单.
拉取黑名单即时通信IM支持通过分页模式拉取全量黑名单,详情可参见:拉取黑名单.
校验黑名单即时通信IM支持以下两种黑名单校验模式:单向校验黑名单关系、双向校验黑名单关系.

校验模式CheckType描述单向校验黑名单关系BlackCheckResult_Type_Single只会检查From_Account的黑名单中是否有To_Account,不会检查To_Account的黑名单中是否有From_Account双向校验黑名单关系BlackCheckResult_Type_Both既会检查From_Account的黑名单中是否有To_Account,也会检查To_Account的黑名单中是否有From_Account单向校验黑名单关系时可能的结果有:Relation描述BlackCheckResult_Type_AWithBFrom_Account的黑名单中有To_Account,但无法确定To_Account的黑名单中是否有From_Account即时通信IM版权所有:腾讯云计算(北京)有限责任公司第28共70页Relation描述BlackCheckResult_Type_NOFrom_Account的黑名单中没有To_Account,但无法确定To_Account的黑名单中是否有From_Account双向校验黑名单关系时可能的结果有:Relation描述BlackCheckResult_Type_BothWayFrom_Account的黑名单中有To_Account,To_Account的黑名单中也有From_AccountBlackCheckResult_Type_AWithBFrom_Account的黑名单中有To_Account,但To_Account的黑名单中没有From_AccountBlackCheckResult_Type_BWithAFrom_Account的黑名单中没有To_Account,但To_Account的黑名单中有From_AccountBlackCheckResult_Type_NOFrom_Account的黑名单中没有To_Account,To_Account的黑名单中也没有From_Account校验黑名单的其他相关信息可参见校验黑名单.
相关文档用户资料与关系链(Android)用户资料与关系链(iOS)快速调通基本功能(Windows)关系链(WebSDK)好友系统消息(WebSDK)即时通信IM版权所有:腾讯云计算(北京)有限责任公司第29共70页应用场景App内双人聊天单聊消息适用于App内双人聊天,类似QQ好友、微信好友的聊天方式.
App管理员发送消息单聊消息可以由App管理员在后台发送消息,也可以模拟其他用户身份发送消息.
App管理员模拟系统消息通过App管理员在后台发送消息,可以模拟系统消息,以系统消息的形式给用户下达通知,App端收到App管理员的自定义消息可做特殊处理.
即时通信IM提供完善的单聊消息能力,同时,我们也提供针对单聊消息的权限控制及扩展能力,帮助客户实现获取消息记录、多终端同步、离线消息推送及携带发送者资料等能力.
单聊消息类型功能类型功能描述文本消息消息内容是普通文本表情消息表情消息为开发者自定义地理位置消息消息内容为地理位置标题、经度、纬度信息图片消息消息内容为图片的URL地址、尺寸、图片大小等信息,最大支持大小为28M的图片语音消息消息内容为语音文件的URL地址、大小、时长等信息,最大支持大小为28M的语音文件文件消息消息内容为文件的URL地址、大小、格式等信息,格式不限,最大支持大小为100M的文件短视频消息消息内容为短视频文件的URL地址、时长、大小、格式等信息,最大支持大小为100M的短视频文件自定义消息开发者自定义的消息类型,例如红包消息、石头剪刀布等形式的消息系统通知消息包含内置的系统通知消息和开发者自定义系统通知消息单聊消息能力单聊消息能力功能描述应用场景消息管理单聊消息最近更新时间:2020-10-1418:25:02即时通信IM版权所有:腾讯云计算(北京)有限责任公司第30共70页单聊消息能力功能描述应用场景发送单聊消息可通过SDK和RESTAPI发送单聊消息App内双人聊天App管理员发送消息App管理员模拟系统消息接收单聊消息可通过SDK接收单聊消息接收在线消息接收离线消息查询历史消息单聊消息权限控制单聊消息权限控制功能描述应用场景App内任意两个用户之间发送单聊消息支持任意两个陌生人发送消息陌生人发送消息App管理员发送单聊消息App内管理员可以给任意用户发送单聊消息App管理员模拟其他用户发送消息App管理员模拟系统消息只允许给好友发送消息支持仅好友发送消息好友发送消息拒绝来自某人的消息可通过黑名单拒绝来自某用户的消息解除好友关系拒绝某人消息单聊消息扩展能力单聊消息扩展能力功能描述应用场景获取聊天记录可通过SDK或RESTAPI获取历史消息获取实时聊天记录定期下载消息记录多终端同步支持单聊消息多终端同步用户多终端消息同步单聊消息离线推送支持Apple、华为、小米、OPPO、vivo和魅族等品牌手机离线推送消息离线推送单聊消息中携带发送者资料可实现消息中携带发送者资料展示发送者昵称、头像等单聊离线消息处理流程即时通信IM版权所有:腾讯云计算(北京)有限责任公司第31共70页单聊消息离线及漫游处理流程:1.
用户A调用sendMessage给用户B发送消息,用户B处于下线状态.
把用户A添加进用户B的最近联系人,缓存大小为100条.
把消息存入离线缓存中,缓存大小30K,时间限制7天.
把消息存入漫游服务器中,时间限制7天.
2.
用户B调用login接口登录即时通信IM.
3.
SDK自动拉取离线缓存中的消息,通过OnNewMessage抛出.
4.
SDK自动拉取最近联系人,通过OnNewMessage接口抛出.
5.
同步消息过程完成,通过OnRefresh接口通知用户已完成消息同步.
6.
用户调用getMessage,如果本地消息不完整,SDK自动拉取漫游服务器.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第32共70页离线消息存储即时通信IM支持离线消息缓存,即当用户不在线时,下次登录仍会拉取到离线消息.
离线消息默认保存7天,如果用户7天内未登录,再次登录时将不能获取到7天前的离线消息.
对于单聊消息,每个用户的离线消息缓存最多保存100个单聊会话的未读消息,每个单聊会话最多保存100条未读消息.
超出限制的部分不会被计入未读计数,但这些消息仍会存到消息漫游中.
对于群消息,则没有这些条数限制.
默认情况下,一个终端通过SDK把离线消息拉取到本地后,即时通信IM服务器便会删除这些离线消息.
如果需要支持多终端,或更换终端后仍想拉取未读的离线消息,需要用户自行管理这些离线消息.
禁用SDK自动已读上报功能后,只有用户显式调用已读上报接口时,即时通信IM服务器才会删除这些离线消息,否则这些离线消息将在到期后自动删除.
如果用户没有显式调用已读上报接口,更换终端后,仍然可以拉取到未读的离线消息.
漫游消息存储即时通信IM支持消息漫游,即用户更换终端的情况下,也可以获取到跟其他用户或者某个群的聊天记录.

默认情况下,单聊消息和群聊消息有7天漫游,超过漫游时长的消息会被删除.
即时通信IM支持在控制台修改消息漫游时长,延长消息漫游时长是增值服务,具体计费说明请参考价格说明.
不同版本的SDK支持延长历史消息存储时长的消息类型不同,详情如下表所示.
SDK版本文本自定义类消息图片文件短语音短视频富媒体消息Android4.
X版本Android3.
X版本Android2.
X版本iOS4.
X版本iOS3.
X版本iOS2.
X版本PCSDK2.
X版本Web与小程序SDK2.
X版本Web与小程序SDK1.
X版本消息存储最近更新时间:2020-12-2211:38:05说明:建议您升级至最新版本的SDK,以便获得更好的用户体验.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第33共70页最近联系人消息最近联系人消息类似QQ的最近联系人列表中,可展示最近跟用户联系过的用户以及最后一条消息.

客户端默认情况下会在登录时通过SDK拉取最近联系人消息,如果本地之前没有存储过,会通过onNewMessage回调取得.
使用最近联系人,登录时会消耗一些流量,获取服务器中相关联系人的最后一条消息.
如果不需要此功能,可通过SDK实现禁用,最近联系人默认存储最近100个联系人,但是保存时长跟最近联系人中的最后一条消息保存时间一致,例如默认如果超过7天跟联系人没有消息,最后一条消息过期后便无法在最近联系人中获取到此用户.

App本地存储默认情况下,SDK内部会对收到的消息进行存储,无需用户进行存储.
用户可调用接口获取本地消息(无网络操作),另外,通过getMessage接口,也会获取本地消息,如果本地消息存在断层,会通过漫游消息补全.

SDK默认不会删除用户消息,但我们提供本地消息删除的能力满足您特殊的需要.

注意:使用本地存储会消耗磁盘以及CPU性能,在不需要存储的场景(如直播场景,更注重消息处理性能,也不关心历史消息),可选择禁用本地存储.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第34共70页应用场景在App退后台或者进程被kill的情况下,有新消息需要提醒用户时,可使用离线推送功能,在iOS端会有APNs推送,Android端则需要用户注册离线消息回调.
APP移动推送服务推荐方案:移动推送TPNS即时通信IM支持苹果APNS推送、小米推送、华为推送、魅族推送、vivo推送、OPPO推送以及GoogleFCM推送,即时通信IMDemo中使用的厂商通道由移动推送TPNS统一提供和维护.
当您需要集成离线推送功能时,您可通过集成移动推送TPNS服务或集成所需厂商的离线推送服务实现:iOSAPNs推送推送格式说明离线推送最近更新时间:2020-12-2415:54:04即时通信IM版权所有:腾讯云计算(北京)有限责任公司第35共70页上图为一条单聊消息和一条群聊消息的示例.
iOSAPNs推送格式详细说明可参考推送格式说明.
基本接口说明支持APNs必须调用以下接口,具体请参考iOSAPNs事件上报:设置Token.
切后台上报未读.
切前台通知.
Ext扩展设置有时应用需要根据情况设置推送的Ext扩展字段,方便用户点击跳转等操作,可以填写到TIMCustomElem中的Ext字段,推送时即时通信IM后台会把该字段填入Ext,请参考自定义离线消息属性定制扩展字段.
设置推送声音即时通信IM版权所有:腾讯云计算(北京)有限责任公司第36共70页有时应用需要根据情况设置单条消息的推送声音,方便特别提醒某类消息,可以把声音填写到TIMCustomElem中的sound字段,推送时即时通信IM后台会把该字段填入Ext,请参考设置自定义推送提示音.
Android离线推送Android在1.
8.
0以后版本支持服务和进程分离,如果App进程被kill,服务仍然存活,可以收到离线推送功能.
具体配置以及设置过程,可参考Android离线推送文档.
后台发送消息后台发送消息时,对于iOS端您可以参考推送格式设置APNs推送的展示形式,对于Android端您可以参考离线推送OfflinePushInfo进行设置.
相关文档管理离线推送证书Apple推送证书申请iOS离线推送配置Android离线推送基本配置即时通信IM版权所有:腾讯云计算(北京)有限责任公司第37共70页应用场景群内收发消息群成员在群内收发消息,类似QQ群、微信群的聊天方式.
App管理员发送消息群聊消息可以由App管理员在后台发送消息,也可以模拟其他用户身份发送消息(即使App管理员或发送者不是群成员,消息依然会下发).
App管理员模拟系统消息通过App管理员在后台发送消息,可以模拟系统消息,以系统消息的形式给指定的群内在线成员,App端收到App管理员的自定义消息可做特殊处理.
群消息的SEQ机制即时通信IM会为每个群维护一个消息SEQ.
SEQ的初始值为1.
群内每产生一条普通消息,即时通信IM后台会将当前SEQ的值作为该消息的SEQ,并且将该SEQ自增1.
群组ID+SEQ,相当于是一条消息的唯一标识.
群聊消息类型消息类型描述文本消息消息内容是普通文本图片消息消息内容为图片URL地址、尺寸、图片大小等信息表情消息表情消息是由开发者自定义语音消息语音数据需要提供时长信息,以秒为单位地理位置消息消息内容为地理位置标题、经度、纬度信息文件消息消息内容为文件的URL地址、大小、格式等信息,格式不限,最大支持100M短视频消息消息内容为短视频文件的URL地址、时长、大小、格式等信息,最大支持100M自定义消息开发者自定义的消息类型,例如红包消息、石头剪刀布等形式的消息群组消息最近更新时间:2020-12-0817:39:31注意:即时通信IM只会为存漫游的消息产生递增SEQ.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第38共70页消息类型描述系统通知消息包含内置的系统通知消息和开发者自定义系统通知消息群聊消息能力类型功能描述应用场景发送群普通消息群成员可以通过IMSDK接口发送消息.
App管理员无需加入群组,即可调用RESTAPI在任意群组中发送消息.
群成员在群内发送消息,App管理员向任意群组发送消息发送群系统消息App管理员无需加入群组,即可调用RESTAPI在群组中发送系统通知.
该系统通知,只有群内在线成员才会收到该消息,不具备漫游能力.
App管理员群内部分或者全部在线成员推送一条时效性较高的提醒群消息离线推送支持Apple、华为、小米、OPPO、vivo、魅族等品牌手机离线推送群聊消息离线推送接收群在线消息群成员可以通过IMSDK接收群聊在线消息在线群成员实时接收群消息群成员获取离线/历史消息群成员通过IMSDK接口查询历史消息群成员上线接收离线消息,群成员查看群聊天记录App后台获取群消息App管理员可通过RESTAPI下载App在某一段时间内产生所有的消息;App管理员亦可通过RESTAPI,获取任意群的聊天记录;App后台可以通过群内发言之后回调,实时获取群消息.
App定期备份消息记录的场景;App需要快速获取指定群组历史消息的场景;App需要实时获取群消息的场景消息删除可通过RESTAPI将历史消息删除,确保该消息不被传播群内恶意信息删除群聊消息中携带发送者资料在群消息中携带发送者的昵称、头像、群名片、用户维度的自定义字段、群成员维度的自定义字段展示消息发送人昵称、头像等信息脏字过滤即时通信IM后台在用户发送的消息中检测到是否包含脏字,如包含则拒绝下发该消息,并向发送者返回错误码80001;即时通信IM已经默认配置了政治类、色情类的脏字,能够满足这两方面的大多数过滤需求.
同时也支持App配置自定义的脏字.
消息安全打击群消息发送控制禁言和群消息发送前回调,是控制群消息发送的两种方式.
禁止群内某个成员发送消息,禁止群内所有成员发消息,App后台过滤或修改消息即时通信IM版权所有:腾讯云计算(北京)有限责任公司第39共70页类型功能描述应用场景群消息接收控制用户针对单个群组设置不同的消息接收选项:接收并提示,接收不提示,屏蔽消息.
设置"接收不提示"后,iOS终端会去掉APNs推送功能用户屏蔽某个群组的消息群消息频率控制控制群普通消息的发送频率,默认值为40条/秒.
频控对象不包括App管理员用RESTAPI发送的群系统消息.
详细请参考下文消息优先级与频率控制.
避免消息刷屏群消息发送控制可以通过以下方式控制群消息的发送:控制方式详细描述群组内禁言禁止某一用户一段时间内在群内发言,只针对单个群组有效.
如果用户退群再重新入群,只要禁言时间没有过期,禁言依旧有效群消息发送前回调在把群消息下发给群成员之前,即时通信IM后台先去App后台询问是否允许下发消息,如果不允许,则拒绝下发消息;App后台在收到回调后,也可对消息内容进行修改并返回给即时通信IM,即时通信IM将使用修改之后的信息进行下发,详情请参考群内发言之前回调;但是即时通信IM在发起该回调后,最多只会等待2秒.
如2秒内未收到应答,直接将消息下发给群成员,不会进行重试消息优先级与频率控制群消息优先级群消息分为3个优先级,如果某个群的消息超过了频率限制,后台会优先下发高优先级的消息.
因此用户应根据消息的重要程度,来选择合适的优先级.
3个优先级从高到低,分别如下:优先级建议选择该优先级的消息类型High红包消息和礼物消息Normal普通文本消息Low点赞消息群消息频控注意:如需携带发送者昵称和头像,则必须把这两个字段的信息导入到即时通信IM的用户资料中.
如果需要携带自定义资料,则需要先在控制台配置自定义字段,然后再提工单申请在消息携带相应的字段.

即时通信IM版权所有:腾讯云计算(北京)有限责任公司第40共70页总消息数频控被频控限制的消息,不会下发,不会存入历史消息,但会给发送人返回成功;会触发群内发言之前回调,但不会触发群内发言之后回调.
优先级频控优先级频控是指单个群每秒最多能发送多少条某优先级的消息,发消息请求只有在通过总消息数频控之后,才会进入优先级频控.
所有的消息都会受到40条/秒的频率限制,可以设置三级优先级,设置了High优先级的消息将有最高优先级,避免被限制,如果同一秒内高优先级消息总数超过40条/秒,高优先级消息也会被抛弃.
群组离线消息处理流程群组离线消息处理流程:1.
用户A调用sendMessage给群组C发送消息,用户B处于下线状态;1.
1把群组C添加进用户B的最近联系人,缓存大小为100条;1.
2用户更新群组的消息信息,包括群组最新消息seq;1.
3把消息存入漫游服务器中,时间限制7天.
2.
用户B调用login接口登录即时通信IM;3.
SDK自动拉取所有群组的消息seq信息,包括最新消息seq和未读计数;4.
SDK自动拉取最近联系人,通过OnNewMessage接口抛出;5.
同步消息过程完成,通过OnRefresh接口通知用户已完成群组数据同步;6.
用户调用getMessage,SDK自动拉取漫游服务器.
说明:总消息数频控是指单个群每秒最多能发送的消息数限制,默认值为40条/秒,采用每秒平均限频.
消息数量超过限制后,后台优先下发优先级相对较高的消息,同等优先级的消息随机排序.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第41共70页消息内容MsgBody说明MsgBody中所填写字段是消息内容.
即时通信IM支持一条消息中包括多种消息元素类别,例如一条消息中既包括文本消息元素,还包括表情消息元素.
因此MsgBody定义为Array格式,可按照需求加入多类消息元素.
消息元素名称为TIMMsgElement,消息元素TIMMsgElement组成MsgBody的示例请参见消息内容MsgBody实例.
消息元素TIMMsgElement的格式统一为:{"MsgType":"","MsgContent":{}}字段类型说明MsgTypeString消息元素类别;目前支持的消息对象包括:TIMTextElem(文本消息),TIMLocationElem(位置消息),TIMFaceElem(表情消息),TIMCustomElem(自定义消息),TIMSoundElem(语音消息),TIMImageElem(图像消息),TIMFileElem(文件消息),TIMVideoFileElem(视频消息).
MsgContentObject消息元素的内容,不同的MsgType有不同的MsgContent格式,具体参见下文.
目前支持消息类别MsgType见下表:MsgType的值类型TIMTextElem文本消息.
TIMLocationElem地理位置消息.
TIMFaceElem表情消息.
TIMCustomElem自定义消息,当接收方为iOS系统且应用处在后台时,此消息类型可携带除文本以外的字段到APNs.
一条组合消息中只能包含一个TIMCustomElem自定义消息元素.
TIMSoundElem语音消息.
(服务端集成RestAPI不支持发送该类消息)TIMImageElem图像消息.
(服务端集成RestAPI不支持发送该类消息)TIMFileElem文件消息.
(服务端集成RestAPI不支持发送该类消息)TIMVideoFileElem视频消息.
(服务端集成RestAPI不支持发送该类消息)消息格式描述最近更新时间:2020-08-0615:29:33即时通信IM版权所有:腾讯云计算(北京)有限责任公司第42共70页消息元素TIMMsgElement文本消息元素{"MsgType":"TIMTextElem","MsgContent":{"Text":"helloworld"}}字段类型说明TextString消息内容.
当接收方为iOS或Android后台在线时,作为离线推送的文本展示.
当接收方为iOS或Android,且应用处在后台时,JSON请求包体中的Text字段作为离线推送的文本展示.
地理位置消息元素{"MsgType":"TIMLocationElem","MsgContent":{"Desc":"someinfo","Latitude":29.
340656774469956,"Longitude":116.
77497920478824}}字段类型说明DescString地理位置描述信息.
LatitudeNumber纬度.
LongitudeNumber经度.
注意:通过服务端集成的RestAPI接口,只能发送TIMTextElem,TIMLocationElem,TIMFaceElem,TIMCustomElem类型的消息,其它类型的消息(TIMSoundElem,TIMImageElem,TIMFileElem,TIMVideoFileElem)不能通过RestAPI接口发送.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第43共70页当接收方为iOS或Android,且应用处在后台时,中文版离线推送文本为"[位置]",英文版离线推送文本为"[Location]".
表情消息元素{"MsgType":"TIMFaceElem","MsgContent":{"Index":1,"Data":"content"}}字段类型说明IndexNumber表情索引,用户自定义.
DataString额外数据.
当接收方为iOS或Android,且应用处在后台时,中文版离线推送文本为"[表情]",英文版离线推送文本为"[Face]".

自定义消息元素{"MsgType":"TIMCustomElem","MsgContent":{"Data":"message","Desc":"notification","Ext":"url","Sound":"dingdong.
aiff"}}字段类型说明DataString自定义消息数据.
不作为APNs的payload字段下发,故从payload中无法获取Data字段.
DescString自定义消息描述信息.
当接收方为iOS或Android后台在线时,做离线推送文本展示.
若发送自定义消息的同时设置了OfflinePushInfo.
Desc字段,此字段会被覆盖,请优先填OfflinePushInfo.
Desc字段.
当消息中只有一个TIMCustomElem自定义消息元素时,如果Desc字段和OfflinePushInfo.
Desc字段都不填写,将收不到该条消息的离线推送,需要填写OfflinePushInfo.
Desc字段才能收到该消息的离线推送.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第44共70页字段类型说明ExtString扩展字段.
当接收方为iOS系统且应用处在后台时,此字段作为APNs请求包Payloads中的Ext键值下发,Ext的协议格式由业务方确定,APNs只做透传.
SoundString自定义APNs推送铃音.
当接收方为iOS系统且应用处在后台时,Desc作为推送文本,Ext字段作为APNS请求包Payloads中的ext键值下发,Data字段不作为APNs的Payloads字段下发.
注意,一条组合消息中只能包含一个TIMCustomElem自定义消息元素.
语音消息元素4.
X版本IMSDK(Android、iOS、Mac以及Windows)发出的语音消息元素的格式如下:{"MsgType":"TIMSoundElem","MsgContent":{"Url":"https://1234-5678187359-1253735226.
cos.
ap-shanghai.
myqcloud.
com/abc123/c9be9d32c05bfb77b3edafa4312c6c7d","Size":62351,"Second":1,"Download_Flag":2}}字段类型说明UrlString语音下载地址,可通过该URL地址直接下载相应语音.
SizeNumber语音数据大小,单位:字节.
SecondNumber语音时长,单位:秒.
Download_FlagNumber语音下载方式标记.
目前Download_Flag取值只能为2,表示可通过Url字段值的URL地址直接下载语音.
注意:不能通过服务端集成的RestAPI接口发送语音消息,发送语音消息需要通过客户端集成相应的接口.
说明:2.
X和3.
X版本IMSDK(Android、iOS、Mac以及Windows)发出的语音消息元素如下:即时通信IM版权所有:腾讯云计算(北京)有限责任公司第45共70页图像消息元素{"MsgType":"TIMImageElem","MsgContent":{"UUID":"1853095_D61040894AC3DE44CDFFFB3EC7EB720F","ImageFormat":1,"ImageInfoArray":[{"Type":1,//原图"Size":1853095,"Width":2448,"Height":3264,"URL":"http://xxx/3200490432214177468_144115198371610486_D61040894AC3DE44CDFFFB3EC7EB720F/0"},{"Type":2,//大图"Size":2565240,"Width":0,"Height":0,"URL":"http://xxx/3200490432214177468_144115198371610486_D61040894AC3DE44CDFFFB3EC7EB720F/720"},{"Type":3,//缩量图"Size":12535,"Width":0,{"MsgType":"TIMSoundElem","MsgContent":{"UUID":"305c0201",//语音序列号,类型为String.
后台用于索引语音的键值.
无法通过该字段下载相应的语音.
若需要获取该语音,请升级IMSDK版本至4.
X.
"Size":62351,//语音数据大小,类型为Number,单位:字节.
"Second":1//语音时长,类型为Number,单位:秒.
}}注意:不能通过服务端集成的RestAPI接口发送图像消息,发送图像消息需要通过客户端集成相应的接口.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第46共70页"Height":0,"URL":"http://xxx/3200490432214177468_144115198371610486_D61040894AC3DE44CDFFFB3EC7EB720F/198"}]}}字段类型说明UUIDString图片序列号.
后台用于索引图片的键值.
ImageFormatNumber图片格式.
JPG=1,GIF=2,PNG=3,BMP=4,其他=255.
ImageInfoArrayArray原图、缩略图或者大图下载信息.
TypeNumber图片类型:1-原图,2-大图,3-缩略图.
SizeNumber图片数据大小,单位:字节.
WidthNumber图片宽度.
HeightNumber图片高度.
URLString图片下载地址.
文件消息元素4.
X版本IMSDK(Android、iOS、Mac以及Windows)发出的文件消息元素的格式如下:{"MsgType":"TIMFileElem","MsgContent":{"Url":"https://7492-5678539059-1253735326.
cos.
ap-shanghai.
myqcloud.
com/abc123/49be9d32c0fbfba7b31dafa4312c6c7d","FileSize":1773552,"FileName":"file:///private/var/Application/tmp/trim.
B75D5F9B-1426-4913-8845-90DD46797FCD.
MOV","Download_Flag":2}}注意:不能通过服务端集成的RestAPI接口发送文件消息,发送文件消息需要通过客户端集成相应的接口.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第47共70页字段类型说明UrlString文件下载地址,可通过该URL地址直接下载相应文件.
FileSizeNumber文件数据大小,单位:字节.
FileNameString文件名称.
Download_FlagNumber文件下载方式标记.
目前Download_Flag取值只能为2,表示可通过Url字段值的URL地址直接下载文件.
视频消息元素4.
X版本IMSDK(Android、iOS、Mac以及Windows)发出的视频消息元素的格式如下:{"MsgType":"TIMVideoFileElem","MsgContent":{"VideoUrl":"https://0345-1400187352-1256635546.
cos.
ap-shanghai.
myqcloud.
com/abcd/f7c6ad3c50af7d83e23efe0a208b90c9","VideoSize":1194603,"VideoSecond":5,"VideoFormat":"mp4","VideoDownloadFlag":2,"ThumbUrl":"https://0345-1400187352-1256635546.
cos.
ap-shanghai.
myqcloud.
com/abcd/a6c170c9c599说明:2.
X和3.
X版本IMSDK(Android、iOS、Mac以及Windows)发出的文件消息元素如下:{"MsgType":"TIMFileElem","MsgContent":{"UUID":"305c02010",//文件序列号,类型为String.
后台用于索引文件的键值.
无法通过该字段下载相应的文件.
若需要获取该文件,请升级IMSDK版本至4.
X.
"FileSize":1773552,//文件数据大小,类型为Number,单位:字节.
"FileName":"file:///private/var/Application/tmp/trim.
B75D5F9B-1426-4913-8845-90DD46797FCD.
MOV"//文件名称,类型为String.
}}注意:不能通过服务端集成的RestAPI接口发送视频消息,发送视频消息需要通过客户端集成相应的接口.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第48共70页280cb06e0523d7a1f37b","ThumbSize":13907,"ThumbWidth":720,"ThumbHeight":1280,"ThumbFormat":"JPG","ThumbDownloadFlag":2}}字段类型说明VideoUrlString视频下载地址.
可通过该URL地址直接下载相应视频.
VideoSizeNumber视频数据大小,单位:字节.
VideoSecondNumber视频时长,单位:秒.
VideoFormatString视频格式,例如mp4.
VideoDownloadFlagNumber视频下载方式标记.
目前VideoDownloadFlag取值只能为2,表示可通过VideoUrl字段值的URL地址直接下载视频.
ThumbUrlString视频缩略图下载地址.
可通过该URL地址直接下载相应视频缩略图.
ThumbSizeNumber缩略图大小,单位:字节.
ThumbWidthNumber缩略图宽度.
ThumbHeightNumber缩略图高度.
ThumbFormatString缩略图格式,例如JPG、BMP等.
ThumbDownloadFlagNumber视频缩略图下载方式标记.
目前ThumbDownloadFlag取值只能为2,表示可通过ThumbUrl字段值的URL地址直接下载视频缩略图.
说明:2.
X和3.
X版本IMSDK(Android、iOS、Mac以及Windows)发出的视频消息元素如下:{"MsgType":"TIMVideoFileElem","MsgContent":{"VideoUUID":"1400123456_dramon_34ca36be7dd214dc50a49238ef80a6b5",//视频序列号,类型为String.
后台用于索引视频的键值.
无法通过该字段下载相应的视频.
若需要获取该视频,请升级IMSDK版本至4.
X.
"VideoSize":1194603,//视频数据大小,类型为Number,单位:字节.
"VideoSecond":5,//视频时长,类型为Number,单位:秒.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第49共70页MsgBody消息内容实例单一文本元素消息单条消息中只包括一个中文本消息元素,文本内容为helloworld.
{"MsgBody":[{"MsgType":"TIMTextElem","MsgContent":{"Text":"helloworld"}}]}组合消息下述的单条消息中包括两个文本消息元素和一个表情元素,消息元素顺序是文本+表情+文本.

{"MsgBody":[{"MsgType":"TIMTextElem","MsgContent":{"Text":"hello"}},{"MsgType":"TIMFaceElem","MsgContent":{"VideoFormat":"mp4",//视频格式,类型为String,例如mp4.
"ThumbUUID":"1400123456_dramon_893f5a7a4872676ae142c08acd49c18a",//视频缩略图序列号,类型为String.
后台用于索引视频缩略图的键值.
无法通过该字段下载相应的视频缩略图.
若需要获取该视频缩略图,请升级IMSDK版本至4.
X.
"ThumbSize":13907,//缩略图大小,类型为Number,单位:字节.
"ThumbWidth":720,//缩略图宽度.
类型为Number.
"ThumbHeight":1280,//缩略图高度.
类型为Number.
"ThumbFormat":"JPG"//缩略图格式,类型为String,例如JPG、BMP等.
}}即时通信IM版权所有:腾讯云计算(北京)有限责任公司第50共70页"Index":1,"Data":"content"}},{"MsgType":"TIMTextElem","MsgContent":{"Text":"world"}}]}ApplePushNotificationService(APNs)相关说明客户端推送展示格式说明未设置帐号昵称如果帐号没有设置昵称,APNs推送只展示推送文本内容.
单聊消息只展示"推送文本",群组消息展示"(群名称):推送文本".
已设置帐号昵称如果帐号设置昵称,单聊消息展示格式为"昵称:推送文本内容",群组消息展示格式为昵称(群名称):推送文本内容.

注意:一条组合消息中只能带一个TIMCustomElem自定义消息元素,其它消息元素数量无限制.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第51共70页组合消息展示格式对于组合消息,按顺序叠加各个消息元素的推送文本作为展示文本.
下述为已设置帐户昵称的单聊消息,推送文本为"helloworld".
注意helloworld中间没有空格,后台按照顺序叠加,各个消息元素推送文本之间不添加任何字符.
如需要在各个不同的消息元素间添加空格或其他字符,需调用方自己控制.
{"MsgBody":[{"MsgType":"TIMTextElem","MsgContent":{"Text":"hello"}},{"MsgType":"TIMCustomElem","MsgContent":{"Data":"message","Desc":"world","Ext":"https://www.
example.
com","Sound":"dingdong.
aiff"}}]}即时通信IM版权所有:腾讯云计算(北京)有限责任公司第52共70页各类消息元素推送文本字段汇总.
MsgType的值类型消息元素推送文本TIMTextElem文本消息.
Text字段.
TIMLocationElem地理位置消息.
中文版离线推送文本为"[位置]";英文版为"[Location]".
TIMFaceElem表情消息.
中文版离线推送文本为"[表情]";英文版为"[Face]".
TIMCustomElem自定义消息.
Desc字段.
昵称和群名称RESTAPI设置接口设置帐号昵称RESTAPI接口:设置资料.
设置群名称RESTAPI接口:修改群组基础资料.
高级应用自定义推送声音,APNs下发扩展字段.
利用自定义消息元素TIMCustomElem,Sound填写自定义声音文件名称,Ext填写下发的扩展字段,请求扩展字段可以从APNs推送PayLoad中的Ext字段获取.
{"To_Account":"lumotuwe5","MsgRandom":121212,"MsgBody":[{"MsgType":"TIMCustomElem","MsgContent":{"Data":"otherinformation","Desc":"hello","Ext":"www.
qq.
com",即时通信IM版权所有:腾讯云计算(北京)有限责任公司第53共70页"Sound":"dingdong.
aiff"}},{"MsgType":"TIMTextElem","MsgContent":{"Text":"world"}}]}客户端收到APNs推送JSONPayload为:{"aps":{"alert":"Nickname:helloworld",//各个消息元素推送文本顺序叠加"badge":5,"sound":"dingdong.
aiff"//对应TIMCustomElem中Sound字段},"ext":"www.
qq.
com"//对应TIMCustomElem中Ext字段}离线推送OfflinePushInfo说明OfflinePushInfo是专用于离线推送配置的JSON对象,允许配置该条消息是否关闭推送、推送文本描述内容、推送透传字符串等.
使用OfflinePushInfo可以方便地设置离线推送信息,无需再通过TIMCustomElem封装实现.
OfflinePushInfo的格式示例如下:{//.
.
.
"MsgBody"这里同MsgBody相关描述"OfflinePushInfo":{"PushFlag":0,"Title":"这是推送标题","Desc":"这是离线推送内容",注意:如果填写了OfflinePushInfo,那么TIMCustomElem中与离线推送有关的信息配置会被忽略.
目前OfflinePushInfo适用于APNs推送,以及Android厂商推送(小米、华为、魅族、OPPO和vivo推送).
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第54共70页"Ext":"这是透传的内容","AndroidInfo":{"Sound":"android.
mp3","OPPOChannelID":"test_OPPO_channel_id"},"ApnsInfo":{"Sound":"apns.
mp3","BadgeMode":1,"Title":"apnstitle","SubTitle":"apnssubtitle","Image":"www.
image.
com"}}}字段说明如下:字段类型属性说明PushFlagInteger选填0表示推送,1表示不离线推送.
TitleString选填离线推送标题.
该字段为iOS和Android共用.
DescString选填离线推送内容.
该字段会覆盖上面各种消息元素TIMMsgElement的离线推送展示文本.
若发送的消息只有一个TIMCustomElem自定义消息元素,该Desc字段会覆盖TIMCustomElem中的Desc字段.
如果两个Desc字段都不填,将收不到该自定义消息的离线推送.
ExtString选填离线推送透传内容.
由于国内各Android手机厂商的推送平台要求各不一样,请保证此字段为JSON格式,否则可能会导致收不到某些厂商的离线推送.
AndroidInfo.
SoundString选填Android离线推送声音文件路径.
AndroidInfo.
HuaWeiChannelIDString选填华为手机EMUI10.
0及以上的通知渠道字段.
AndroidInfo.
XiaoMiChannelIDString选填小米手机MIUI10及以上的通知类别(Channel)适配字段.
AndroidInfo.
OPPOChannelIDString选填OPPO手机Android8.
0及以上的NotificationChannel通知适配字段.
AndroidInfo.
GoogleChannelIDString选填Google手机Android8.
0及以上的通知渠道字段.
Google推送新接口(上传证书文件)支持channelid,旧接口(填写服务器密钥)不支持.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第55共70页字段类型属性说明ApnsInfo.
BadgeModeInteger选填这个字段缺省或者为0表示需要计数,为1表示本条消息不需要计数,即右上角图标数字不增加.
ApnsInfo.
TitleString选填该字段用于标识APNs推送的标题,若填写则会覆盖最上层Title.
ApnsInfo.
SubTitleString选填该字段用于标识APNs推送的子标题.
ApnsInfo.
ImageString选填该字段用于标识APNs携带的图片地址,当客户端拿到该字段时,可以通过下载图片资源的方式将图片展示在弹窗上.
参考ApplePushNotificationService(APNs)苹果推送开发文档.
iOS离线消息推送配置:离线推送(iOS).
注意:由于APNs推送限制数据包大小不能超过4K,因此除去其他控制字段,建议Desc和Ext字段之和不要超过3K.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第56共70页群组系统简介群组系统是一个支持多人聊天的即时通信系统,以下视频为您详细介绍群组系统:点击查看视频群组系统所具备的基本能力包括:完备的群组管理能力:创建/解散群组、成员管理、群组资料管理、成员资料管理等.
稳定可靠的消息收发能力,完善的群组消息管理机制:权限控制,禁言,脏词过滤,消息回调,消息漫游等.
根据常见使用场景,默认配置了好友工作群(Work)、陌生人社交群(Public)、临时会议群(Meeting)和直播群(AVChatRoom)四个群组类型,并支持业务根据自身需要自定义群组类型.
可拓展的群成员人数上限:非直播群成员人数上限最高支持付费拓展到6000人,详情请参阅价格说明.
直播群(AVChatRoom)成员人数无上限.
在Web/小程序端,直播群(AVChatRoom)支持用户以游客身份(即不需要登录)接收消息.
除此之外,即时通信IM群组系统具备高度可定制性,具体包括:自定义消息格式自定义群组ID自定义字段自定义群组类型自定义回调群成员角色介绍群组中各成员的角色及其权限如下表:群组成员角色描述管理权限群组系统群组系统最近更新时间:2020-10-2914:57:00注意:直播群(AVChatRoom)不设成员人数上限,但如果预期群成员会出现短时间内激增的场景(例如举行大型在线活动,单群成员人数达到5万或以上等情况),请提前联系腾讯云客服或商务工作人员,提供SDKAppID和活动预期发生时间进行服务资源报备.
目前仅非直播群具备历史消息存储能力(体验版及专业版套餐包默认7天,旗舰版默认30天).
如需保存更长时间,您可以在控制台修改消息历史消息存储时长.
延长历史消息存储时长是付费增值服务,具体计费说明请参考价格说明.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第57共70页群组成员角色描述管理权限普通成员不具备管理权限的群成员好友工作群(Work)中,普通成员具备修改群组资料的权限管理员由群主任命的、协助群主来管理群组的群成员,拥有一定的管理权限修改群组基本资料将普通群成员踢出群将普通群成员禁言(即禁止其在一段时间内发言)审批其他用户的入群申请好友工作群(Work)默认不支持设置管理员群主群组的创建者,在群组中拥有最高的管理权限群主具备管理员所拥有的各项权限之外,还拥有如下权限:任命/取消管理员将管理员踢出群组将管理员禁言解散群组转让群组App管理员具备管理App中所有群组权限的一种特殊身份,能力超过群主App管理员可以不是群组中的成员,但是拥有群主具备的所有权限群组类型介绍根据常见使用场景,默认配置了以下群组类型:群组类型适用场景好友工作群(Work)类似普通微信群,创建后仅支持已在群内的好友邀请加群,且无需被邀请方同意或群主审批陌生人社交群(Public)类似QQ群,创建后群主可以指定群管理员,用户搜索群ID发起加群申请后,需要群主或管理员审批通过才能入群临时会议群(Meeting)创建后可以随意进出,且支持查看入群前消息;适合用于音视频会议场景、在线教育场景等与实时音视频产品结合的场景直播群(AVChatRoom)创建后可以随意进出,没有群成员数量上限,但不支持历史消息存储;适合与直播产品结合,用于弹幕聊天场景群组基础能力操作差异功能项好友工作群(Work)陌生人社交群(Public)临时会议群(Meeting)直播群(AVChatRoom)可用成员角色群主普通成员App管理员群主管理员普通成员App管理员群主管理员普通成员App管理员群主普通成员App管理员即时通信IM版权所有:腾讯云计算(北京)有限责任公司第58共70页功能项好友工作群(Work)陌生人社交群(Public)临时会议群(Meeting)直播群(AVChatRoom)修改群基础资料的权限普通成员群管理员群主App管理员群主App管理员App管理员获取群成员信息可获取全部群成员信息可获取全部成员信息可获取全部成员信息只能获取前300个群成员的信息解散群只有App管理员可以解散群群主和App管理员可以解散群群主和App管理员可以解散群群主和App管理员可以解散群加群方式差异功能项好友工作群(Work)陌生人社交群(Public)临时会议群(Meeting)直播群(AVChatRoom)是否支持精确搜索群ID加群不支持支持支持支持是否支持模糊搜索群信息加群不支持不支持不支持不支持是否支持申请加群不支持支持,但需要群主或管理员审批支持,且无需审批支持,且无需审批是否支持成员邀请他人加群支持不支持不支持不支持成员管理能力差异功能项好友工作群(Work)陌生人社交群(Public)临时会议群(Meeting)直播群(AVChatRoom)说明:对于好友工作群(Work),普通成员只能修改群名称、简介、公告、群头像URL,不能修改其他群基础资料.
如果群类型中的角色不能满足业务需求,可以通过设置群成员自定义字段来增加新角色.
获取部分群成员的信息,常用于直播群(AVChatRoom)中只需要展示部分群成员列表的场景.

说明:精确搜索:非群成员通过群组ID查找群组;模糊搜索:非群成员通过群名称等字段查找群组.
入群审批:群主和管理员可以针对群外用户的加群申请选择"同意"或"拒绝",通过审批的用户方能加入群组.

不支持邀请加群的群类型,可以在App中通过群内成员分享群ID给他人申请加群达到类似效果.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第59共70页功能项好友工作群(Work)陌生人社交群(Public)临时会议群(Meeting)直播群(AVChatRoom)是否支持设置管理员不支持支持支持不支持是否支持群主退群支持,退群后进入无群主状态不支持不支持不支持是否支持"踢人"支持,群主可踢人支持,群主和管理员有"踢人"权限,但管理员仅支持踢普通群成员支持,群主和管理员有"踢人"权限,但管理员仅支持踢普通群成员不支持,可用"禁言"功能达到类似效果是否支持"禁言"不支持支持,群主和管理员有"禁言"权限,但管理员仅支持禁言普通群成员支持,群主和管理员有"禁言"权限,但管理员仅支持禁言普通群成员支持,群主有"禁言"权限定期移除不在线的群成员支持,但默认不开启支持,但默认不开启支持,但默认不开启不支持群组限制差异功能项好友工作群(Work)/陌生人社交群(Public)/临时会议群(Meeting)直播群(AVChatRoom)成员数量上限体验版:20人/群专业版:默认为200人/群,最高支持增值扩展至2000人/群旗舰版:默认为2000人/群,最高支持增值扩展至6000人/群无上限群组数量体验版:最多同时存在100个,已解散的群组不计数专业版或旗舰版:无上限体验版:最多同时存在10个,已解散的群组不计数专业版:最多同时存在50个,已解散的群组不计数,支持增值扩展直播群创建数至无上限旗舰版:无上限注意:被禁言的群成员,在禁言时间内无法发送群聊消息.
注意:专业版或旗舰版SDKAppID下,所有群类型日净增群组数(即创建群组数减去解散群组数)上限为1万个.

专业版或旗舰版SDKAppID下,免费峰值群组数为10万个/月,超出免费量将产生套餐外超量费用,建议及时解散无需继续使用的群组.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第60共70页消息能力差异功能项好友工作群(Work)陌生人社交群(Public)临时会议群(Meeting)直播群(AVChatRoom)是否支持未读消息计数支持支持不支持不支持是否支持查看入群前消息记录不支持不支持支持不支持是否支持历史消息存储支持支持支持不支持是否支持成员变更通知支持支持不支持支持创建群组后是否需要发一条消息激活需要不需要不需要不需要默认消息接收选项接收在线推送消息和离线推送接收在线推送消息和离线推送只接收在线推送消息只接收在线推送消息是否支持用户以游客身份(即不需要登录)接收群消息不支持不支持不支持支持批量导入与自动回收差异功能项好友工作群(Work)/陌生人社交群(Public)/临时会议群(Meeting)直播群(AVChatRoom)允许导入群、群成员和群消息允许导入群、群成员和群消息,适用于从第三方平台迁移历史群组到即时通信IM时使用不允许批量导入群、群成员和群消息,只能使用现有的群、群成员和群消息群组自动回收时间(秒)后台不会回收群组,除非群主解散,或者所有成员都退出群组后台不会回收群组,除非群主解散,或者所有成员都退出群组群组数据结构介绍注意:需要激活的群组,在群主发消息前为未激活状态,对群主以外的其他群成员不可见,而不需要激活的群组,创建后即对所有群成员可见.
离线推送目前只支持Android(Android离线推送)和iOS(APNs推送).
好友工作群(Work)、陌生人社交群(Public)和临时会议群(Meeting)具备历史消息存储能力,默认免费存储7天(旗舰版默认30天),如需保存更长时间,您可以在控制台修改消息存储时长.
延长历史消息存储时长是付费增值服务,详情请参见价格说明.
注意:如果需要开启群组回收功能,可以根据工单模板提交工单进行申请.
配置后,将会根据群组类型清理不活跃群组(群组不活跃是指群组中既没人发言,也没有成员变更).
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第61共70页群基础资料字段名称类型描述备注GroupIdString群组的唯一标识只读群组ID,App内保证唯一,其格式前缀为@TGS#.
另外,App亦可自定义群组IDTypeString群组类型只读默认支持以下群组类型:好友工作群(Work)、陌生人社交群(Public)、临时会议群(Meeting)、直播群(AVChatRoom),详情请参阅群组类型介绍旧版本SDK中还包含Private、ChatRoom以及BChatRoom类型,不建议使用NameString群组名称可读可写.
最长30字节,不可调整IntroductionString群组简介可读可写.
最长240字节,不可调整NotificationString群组公告可读可写.
最长300字节,不可调整FaceUrlString群组头像URL可读可写.
最长100字节,不可调整Owner_AccountString群主ID只读CreateTimeInteger群组的创建时间只读InfoSeqInteger群资料的每次变都会增加该值只读LastInfoTimeInteger群组最后一次信息变更时间只读LastMsgTimeInteger群组内最后发消息的时间只读NextMsgSeqInteger群内下一条消息的Seq只读群组内每一条消息都有一条唯一的消息Seq,且该Seq是按照发消息顺序而连续的.
从1开始,群内每增加一条消息,NextMsgSeq就会增加1MemberNumInteger当前成员数量只读MaxMemberNumInteger最大成员数量-即时通信IM版权所有:腾讯云计算(北京)有限责任公司第62共70页字段名称类型描述备注ApplyJoinOptionString申请加群选项申请加群选项包括如下几种:DisableApply表示禁止任何人申请加入NeedPermission表示需要群主或管理员审批FreeAccess表示允许无需审批自由加入群组群成员资料字段名称类型描述备注Member_AccountString群成员ID只读RoleString群内身份群内身份,包括Owner群主、Admin群管理员以及Member群成员JoinTimeInteger入群时间只读MsgSeqInteger该成员当前已读消息Seq只读MsgFlagString消息接收选项消息接收选项,包括如下几种:AcceptAndNotify表示接收并提示AcceptNotNotify表示接收不提示(不会触发APNs远程推送)Discard表示屏蔽群消息(不会向客户端推送消息)LastSendMsgTimeInteger最后发送消息的时间只读NameCardString群名片可读可写自定义群组类型在实际使用中,如果IM提供的群组类型无法满足您的需求,您可以按照工单模板准备相关信息,然后提交工单申请修改现有群组类型或新增自定义群组类型.
例如,某种办公场景下使用的群组,它与好友工作群(Work)相似但需要群内任意成员都具有最高级别的管理权限且可以查看入群之前的历史消息.
那么您可以选择以下方案:选择使用好友工作群(Work),然后提交工单申请开启"是否支持查看入群前历史消息"和"是否允许普通成员踢人"选项.

注意:群组名称、群组简介、群组公告和群组头像URL字段的修改权限如下:好友工作群(Work)中,任何群成员都可以修改.
其他群组类型则需要非普通成员角色才可修改.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第63共70页提交工单申请定义一种新的群组类型:OAGroup,指定好友工作群(Work)为参考类型,并开启"是否支持查看入群前历史消息"和"是否允许普通成员踢人"选项.
自定义群组ID默认情况下,App创建群时,即时通信IM会为新创建的群组分配一个默认的群组ID.
该ID将以@TGS#开头,且保证在App中唯一.
为了使得群组ID更加简单,便于记忆传播,即时通信IM支持App在通过RESTAPI创建群组时自定义群组ID.
自定义群组ID必须为可打印ASCII字符(0x20-0x7e),最长48个字节,且前缀不能为@TGS#(避免与默认分配的群组ID混淆).
自定义字段即时通信IM支持App根据业务需求,在群组和群成员两个维度上设置自定义字段.
群组维度最多支持20个字段,群成员维度最多支持5个字段.
利用自定义字段,App可以将一些额外数据附加到群组之上,并可以通过现有接口进行读写操作.
自定义字段设置并使用后无法删除.
特性介绍每个自定义字段有以下特性:为Key-Value形式.
Key为String类型,长度不超过16字节,其命名仅支持英文大小写字母、数字、下划线.

Value为用户自定义Buffer,可以为二进制数据,群维度的Value长度不超过512字节,群成员维度的Value长度不超过64字节.
支持配置每个Key的最小读权限、最小写权限.
每个自定义字段的读写权限从高到低分别为:1.
App管理员可读/可写.
2.
群主可读/可写.
3.
群管理员可读/可写.
4.
群成员可读/可写.
5.
任何人(包括非成员)可读/可写.
例如,App需要在群组中扩展一个字段GroupLevel,其Value为一个数字,用于记录该群的等级信息.
假设等级信息需要App后台计算得出,那么该字段的最小写权限应当为"App管理员可写".
该字段应当为群的公开资料,故而其最小读权限应当为"任何人(包括非成员)可读".
注意:新增群组类型时,需要指定一种群组类型作为参考类型.
其中,旧SDK版本中的BChatRoom类型不能作为参考类型.
成功配置后,除了在申请工单中指定要修改的特性外,新群组类型具有的特性与参考类型是相同的.

配置方法这两个维度的自定义字段,都可以通过即时通信IM控制台进行配置.
配置群成员维度的自定义字段前,需要先指定群组类型.
但对于直播群(AVChatRoom)及以其为参考的群组类型,因为不存储所有群成员的资料,所以不支持群成员维度的自定义字段.
"自己的读写权限"是指对于用户本人的群成员维度自定义字段值,自己是否有读写权限.
例如,群成员维度的自定义字段"MemberLevel",用于表示成员在群组中的等级,本人可以读取自己的等级,但无权修改自己的等级,因此字段的"自己的读写权限"为"可读/不可写".
自定义回调第三方回调是App实现特殊需求的重要方式之一,为用户提供了自定义行为的能力.
即时通信IM群组系统支持多种回调,具体参见第三方回调简介以及回调命令列表.
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第65共70页即时通信IM根据常见使用场景,默认配置了以下群组形态:好友工作群(Work)、陌生人社交群(Public)、临时会议群(Meeting)和直播群(AVChatRoom),详细请参阅群组类型介绍.
针对群组,可进行以下操作:群组操作说明备注创建群组创建一个新的群组,可指定群组类型、群组名称以及要加入的用户列表,创建成功后返回群组ID;群组ID为群组唯一识别标识,可通过群组ID进行收发消息等其他群组操作.
每个App每天净消耗群组上限为10000个.
转让群组更换群主身份给他人.
App管理员可以通过RESTAPI转让群组,除此之外只有群主可以转让群组.
解散群组解散App上创建的某个群组,群组被解散时,群组原有成员均会收到解散群组的系统消息.
App管理员可调用RESTAPI接口解散任意群组.
在App端解散群组权限受成员角色限制,陌生人社交群(Public)、临时会议群(Meeting)、直播群(AVChatRoom)只有群主可以解散群组;好友工作群(Work)群内任何人都无法解散群组.
群组资料管理群组资料是指单个群组维度的属性,包括群名称、简介、公告、群主等,以及群组维度自定义字段.

群资料管理说明备注群组管理最近更新时间:2020-12-2211:45:14注意:创建群组时,即时通信IM会分配默认群组ID,该群组ID以@TGS#开头.
但也支持用户指定群组ID,详情请参阅自定义群组ID.
创建群组之后,群主所在终端会收到创建群组系统消息,目的在于保持多终端群组同步(一个终端创建群组之后,所有终端都能立即感知到该群已被创建).
即时通信IM版权所有:腾讯云计算(北京)有限责任公司第66共70页群资料管理说明备注获取群组资料拉取群组的基本资料,如果想拉取自定义资料,可通过设置拉取字段的接口进行设置群成员获取群组资料:成员获取本群组资料;非群成员获取群组资料:非群成员获取群组资料只能获取公开信息;获取本人在群里的资料:可以获取本人在所有群内的资料,也可以获取单个群内本人在群里的资料;获取群内某个人的资料:直播群(AVChatRoom)只能获得部分成员的资料,包括群主、管理员和部分群成员修改群组资料可修改群组名称、群组简介、群组公告、群组头像、群名片,修改加群选项、群纬度自定义字段、用户群内身份、群成员维度自定义字段和接收群消息选项等信息目前App可以在控制台上自助配置群名称、简介、公告、头像URL的变更回调.
如果需要启用其他群资料(包括群维度的自定义字段)的变更回调,请提工单申请群成员/群组管理群成员管理包括以下两个方面:获取/修改自己在群组中的信息,这些信息仅仅可以由用户自己获取/设置,例如消息接收选项等.

获取/修改其他群成员的信息,包括群成员的身份、入群时间、最后发消息时间、群名片以及群成员维度的自定义资料.

展开全文