即时通信 IM 开放了用户资料托管能力,提供资料相关的一整套完整解决方案。如果您想让每个用户都有自己的资料,并且轻松实现资料的设置和拉取功能,那么您可以选择即时通信 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 管理员可写 |
可选择写权限的一个或多个类型 |
目前即时通信 IM 支持的标配资料字段如下:
字段名称 | 类型 | 描述 | 更新时有 Push | 备注 |
---|---|---|---|---|
Tag_Profile_IM_Nick | string | 昵称 | 有 | 长度不得超过500个字节 |
Tag_Profile_IM_Gender | string | 性别 | 有 |
Gender_Type_Unknown:没设置性别 Gender_Type_Female:女性 Gender_Type_Male:男性 |
Tag_Profile_IM_BirthDay | uint32 | 生日 | 有 | 推荐用法:20190419 |
Tag_Profile_IM_Location | string | 所在地 | 有 |
长度不得超过16个字节,推荐用法如下: App 本地定义一套数字到地名的映射关系 后台实际保存的是4个 uint32_t 类型的数字 其中第一个 uint32_t 表示国家 第二个 uint32_t 用于表示省份 第三个 uint32_t 用于表示城市 第四个 uint32_t 用于表示区县 |
Tag_Profile_IM_SelfSignature | string | 个性签名 | 有 | 长度不得超过500个字节 |
Tag_Profile_IM_AllowType | string | 加好友验证方式 | 有 |
AllowType_Type_NeedConfirm:需要经过自己确认对方才能添加自己为好友 AllowType_Type_AllowAny:允许任何人添加自己为好友 AllowType_Type_DenyAny:不允许任何人添加自己为好友 |
Tag_Profile_IM_Language | uint32 | 语言 | 有 | 无 |
Tag_Profile_IM_Image | string | 头像URL | 有 | 长度不得超过500个字节 |
Tag_Profile_IM_MsgSettings | uint32 | 消息设置 | 有 |
标志位: Bit0:置0表示接收消息,置1则不接收消息 |
Tag_Profile_IM_AdminForbidType | string | 管理员禁止加好友标识 | 有 |
AdminForbid_Type_None:默认值,允许加好友 AdminForbid_Type_SendOut:禁止该用户发起加好友请求 |
Tag_Profile_IM_Level | uint32 | 等级 | 有 | 通常一个 UINT-8 数据即可保存一个等级信息 您可以考虑拆分保存,从而实现多种角色的等级信息 |
Tag_Profile_IM_Role | uint32 | 角色 | 有 | 通常一个 UINT-8 数据即可保存一个角色信息 您可以考虑拆分保存,从而保存多种角色信息 |
自定义资料字段是各 App 根据各自业务需要而设置的用户数据。通过自定义资料,各 App 可以将一些额外数据附加到用户资料上,并通过现有接口进行读写操作。
App 管理员可以通过即时通信 IM 控制台>【应用配置】>【功能配置】 申请自定义资料字段,申请提交后,自定义资料字段将在5分钟内生效。
申请自定义资料字段时,需要为每一个自定义资料字段提交如下资料:
自定义资料字段的命名规则如下:
本文介绍使用SDK创建Custom Container函数。 SDK示例 本文以使用Go SDK创建Custo...
功能介绍 一般由VR眼镜调用,用于获取可以连接的GPU云服务器的IP地址等信息。 接...
1. 接口描述 接口请求域名: scf.tencentcloudapi.com 。 获取别名的详细信息,...
阿里云数据中台产品矩阵是以Dataphin为基座 以Quick系列为业务场景化切入。 举例...
昨天,DNjournal发布了新一期的DN 域名交易 榜, 英文域名 Memento.com以148,000...
网站服务器的带宽选择,对于我们的网站来说是很重要的,如果所选择的服务器带宽...
Java语言的特点有哪些?Java编程入门知识分享,Java编程具有用户友好性和灵活性,...
基础版/企业版/旗舰版 网页防篡改版 父主题: 开通主机防护...
1. 接口描述 接口请求域名: bm.tencentcloudapi.com 。 修改自定义脚本 默认接...
同期群,在用户(客户)分析中是一个很重要的模式。通过在一段时间后逐渐递减的...