tencent cloud

文档反馈

最后更新时间:2023-08-03 17:02:51

    功能描述

    用户可以设置和获取个人的昵称、头像、签名等资料信息,也可以获取到陌生人的资料信息。

    用户资料管理

    查询自己的资料

    接口
    chat.getMyProfile();
    参数
    返回值
    Promise
    示例
    let promise = chat.getMyProfile();
    promise.then(function(imResponse) {
    console.log(imResponse.data); // 个人资料 - Profile 实例
    }).catch(function(imError) {
    console.warn('getMyProfile error:', imError); // 获取个人资料失败的相关信息
    });

    查询其他用户资料

    注意
    1. 如果您没有配置自定义资料字段,或者配置了自定义资料字段,但是没有设置 value,此接口将不会返回自定义资料的内容。
    2. 每次拉取的用户数不超过100,避免因回包数据量太大导致回包失败。如果传入的数组长度大于100,则只取前100个用户进行查询,其余丢弃。
    接口
    chat.getUserProfile(options);
    参数
    参数 options 为 Object 类型,包含的属性值如下:
    Name
    Type
    Description
    userIDList
    Array
    用户的账号列表,类型为数组
    返回值
    Promise
    示例
    let promise = chat.getUserProfile({
    userIDList: ['user1', 'user2'] // 请注意:即使只拉取一个用户的资料,也需要用数组类型,例如:userIDList: ['user1']
    });
    promise.then(function(imResponse) {
    console.log(imResponse.data); // 存储用户资料的数组 - [Profile]
    }).catch(function(imError) {
    console.warn('getUserProfile error:', imError); // 获取其他用户资料失败的相关信息
    });

    更新个人资料

    接口
    chat.updateMyProfile(options);
    参数
    参数 options 为 Object 类型,包含的属性值如下:
    Name
    Type
    Description
    nick
    String | undefined
    昵称
    avatar
    String | undefined
    头像地址
    gender
    String | undefined
    性别:
    TencentCloudChat.TYPES.GENDER_UNKNOWN(未设置性别)
    TencentCloudChat.TYPES.GENDER_FEMALE(女)
    TencentCloudChat.TYPES.GENDER_MALE(男)
    selfSignature
    String | undefined
    个性签名
    allowType
    String | undefined
    当被人加好友时
    TencentCloudChat.TYPES.ALLOW_TYPE_ALLOW_ANY(允许直接加为好友)
    TencentCloudChat.TYPES.ALLOW_TYPE_NEED_CONFIRM(需要验证)
    TencentCloudChat.TYPES.ALLOW_TYPE_DENY_ANY(拒绝)
    birthday
    Number | undefined
    生日,推荐用法:20000101
    location
    String | undefined
    所在地 推荐用法:App 本地定义一套数字到地名的映射关系 后台实际保存的是4个 uint32_t 类型的数字:
    第一个 uint32_t 表示国家;
    第二个 uint32_t 用于表示省;
    第三个 uint32_t 用于表示市;
    第四个 uint32_t 用于表示区(县);
    language
    Number | undefined
    语言
    messageSettings
    Number | undefined
    消息设置,
    0:接收消息
    1:不接收消息
    adminForbidType
    String | undefined
    管理员禁止加好友标识:
    TencentCloudChat.TYPES.FORBID_TYPE_NONE(默认值,允许加好友)
    TencentCloudChat.TYPES.FORBID_TYPE_SEND_OUT(禁止该用户发起加好友请求)
    level
    Number | undefined
    等级,建议拆分以保存多种角色的等级信息
    role
    Number | undefined
    角色,建议拆分以保存多种角色信息
    profileCustomField
    Array | undefined
    自定义资料键值对集合,可根据业务侧需要使用
    返回值
    Promise
    示例
    // 修改个人标配资料
    let promise = chat.updateMyProfile({
    nick: '我的昵称',
    avatar: 'http(s)://url/to/image.jpg',
    gender: TencentCloudChat.TYPES.GENDER_MALE,
    selfSignature: '我的个性签名',
    allowType: TencentCloudChat.TYPES.ALLOW_TYPE_ALLOW_ANY
    });
    promise.then(function(imResponse) {
    console.log(imResponse.data); // 更新资料成功
    }).catch(function(imError) {
    console.warn('updateMyProfile error:', imError); // 更新资料失败的相关信息
    });
    // 修改个人自定义资料
    // 自定义资料字段需要预先在控制台配置,
    let promise = chat.updateMyProfile({
    // 这里要求您已在即时通信 IM 控制台>【应用配置】>【功能配置】 申请了自定义资料字段 Tag_Profile_Custom_Test1
    // 注意!即使只有一个自定义资料字段,profileCustomField 也需要用数组类型
    profileCustomField: [
    {
    key: 'Tag_Profile_Custom_Test1',
    value: '我的自定义资料1'
    }
    ]
    });
    promise.then(function(imResponse) {
    console.log(imResponse.data); // 更新资料成功
    }).catch(function(imError) {
    console.warn('updateMyProfile error:', imError); // 更新资料失败的相关信息
    });
    // 修改个人标配资料和自定义资料
    let promise = chat.updateMyProfile({
    nick: '我的昵称',
    // 这里要求您已在即时通信 IM 控制台>【应用配置】>【功能配置】
    // 申请了自定义资料字段 Tag_Profile_Custom_Test1 和 Tag_Profile_Custom_Test2
    profileCustomField: [
    {
    key: 'Tag_Profile_Custom_Test1',
    value: '我的自定义资料1'
    },
    {
    key: 'Tag_Profile_Custom_Test2',
    value: '我的自定义资料2'
    },
    ]
    });
    promise.then(function(imResponse) {
    console.log(imResponse.data); // 更新资料成功
    }).catch(function(imError) {
    console.warn('updateMyProfile error:', imError); // 更新资料失败的相关信息
    });
    
    联系我们

    联系我们,为您的业务提供专属服务。

    技术支持

    如果你想寻求进一步的帮助,通过工单与我们进行联络。我们提供7x24的工单服务。

    7x24 电话支持