Unity3D C# 即时通讯 SDK 用户管理 - 开发者中心

Example

// 修改用户信息扩展字段
String newUserExtendedData = "{\"user_avatar\":\"https://url\",\"user_name\":\"new_name\",\"user_sex\":\"male\",\"user_birth\":\"1970-01-01\",\"user_phone\":\"12345678901\"}";

zim.updateUserExtendedData(newUserExtendedData, new ZIMUserExtendedDataUpdatedCallback() {
        @Override
        public void onUserExtendedDataUpdated(String extendedData, ZIMError errorInfo) {
            if(errorInfo.code == ZIMErrorCode.SUCCESS) {
                // 修改成功
            }
        }
});

1

Copied!

Example

// 更新用户信息的扩展字段。
NSString *extendedData = @"";

[zim updateUserExtendedData:extendedData callback:^(NSString * _Nonnull extendedData, ZIMError * _Nonnull errorInfo) {
        
    }];

1

Copied!

Example

// 修改用户信息的扩展字段
String newUserExtendedData = "{\"user_avatar\":\"https://url\",\"user_name\":\"new_name\",\"user_sex\":\"male\",\"user_birth\":\"1970-01-01\",\"user_phone\":\"12345678901\"}";

try {
    ZIMUserExtendedDataUpdatedResult result =
        await ZIM.getInstance()!.updateUserExtendedData(newUserExtendedData);
    
    } on PlatformException catch (onError) {
        // 根据 onError 的返回值处理写操作失败的逻辑
    }

1

Copied!

Example

std::string new_user_extended_data = "{\"user_avatar\":\"https://url\",\"user_name\":\"new_name\",\"user_sex\":\"male\",\"user_birth\":\"1970-01-01\",\"user_phone\":\"12345678901\"}";

zim_->updateUserExtendedData(new_user_extended_data, [=](const std::string &extended_data, zim::ZIMError error_info){
    if (errorInfo.code == ZIM_ERROR_CODE_SUCCESS) {
        // 修改成功
    }
});

1

Copied!

Example

var extendedData = JSON.stringify({ age: 18, birthdy: '2000-01-01' });

zim.updateUserExtendedData(extendedData)
    .then(function ({ extendedData }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

var extendedData = JSON.stringify({ age: 18, birthdy: '2000-01-01' });

zim.updateUserExtendedData(extendedData)
    .then(function ({ extendedData }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

string newUserExtendedData = "{\"user_avatar\":\"https://url\",\"user_name\":\"new_name\",\"user_sex\":\"male\",\"user_birth\":\"1970-01-01\",\"user_phone\":\"12345678901\"}";

ZIM.GetInstance().UpdateUserExtendedData(newUserExtendedData, 
(string extendedData, ZIMError errorInfo) => {
    if(errorInfo.code == ZIMErrorCode.Success) {
        // 操作成功
    }
});

1

Copied!

Example

// 修改用户名称
// userName 最大 256 字节的字符串，无特殊字符限制。
String newUserName = "new_name";
zim.updateUserName(newUserName, new ZIMUserNameUpdatedCallback() {
        @Override
        public void onUserNameUpdated(String userName, ZIMError errorInfo) {
            if(errorInfo.code == ZIMErrorCode.SUCCESS) {
                // 修改成功
            }
        }
});

1

Copied!

Example

// 修改用户名。
// `userName` 参数的长度可以达到256字节，字符数没有限制。
NSString *userName = @"";

[zim updateUserName:userName callback:^(NSString * _Nonnull userName, ZIMError * _Nonnull errorInfo) {
        
}];

1

Copied!

Example

// 修改用户名
// userName 是一个最多256字节的字符串，没有特殊字符限制。
try {
    ZIMUserNameUpdatedResult result =
        await ZIM.getInstance()!.updateUserName('userName');
        // 成功修改的逻辑写在这里
    } on PlatformException catch (onError) {
        // 根据 onError 编写和修改失败的逻辑
    }

1

Copied!

Example

// 修改用户名称
// userName 是一个最大长度为256字节的字符串，没有特殊字符限制。
std::string new_user_name = "新名称";

zim_->updateUserName(new_user_name, [=](const std::string &userName, const zim::ZIMError &errorInfo){
    if (errorInfo.code == ZIM_ERROR_CODE_SUCCESS) {
        // 修改成功
    }
});

1

Copied!

Example

// 修改用户名
// userName 是一个最多256字节的字符串，没有特殊字符限制。
var userName = '新名称';

zim.updateUserName(userName)
    .then(function ({ userName }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

// 修改用户名
// userName 是一个最多256字节的字符串，没有特殊字符限制。
var userName = '新用户名';

zim.updateUserName(userName)
    .then(function ({ userName }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

// 修改用户名
// userName 是一个最大长度为256字节的字符串，没有特殊字符限制。
string newUserName = "新用户名";
ZIM.GetInstance().UpdateUserName(newUserName, (string userName, ZIMError errorInfo) => {
    if(errorInfo.code == ZIMErrorCode.Success) {
        // 操作成功
    }
});

1

Copied!

Example

// 设置用户头像
// URL 最大 500 字节，无特殊字符限制
String userAvatarUrl = "xxx";
zim.updateUserAvatarUrl(userAvatarUrl, new ZIMUserAvatarUrlUpdatedCallback() {
    @Override
    public void onUserAvatarUrlUpdated(String userAvatarUrl, ZIMError errorInfo) {
        if(errorInfo.code == ZIMErrorCode.SUCCESS) {
            // 设置成功
        }
    }
});

1

Copied!

Example

// 设置用户头像。
// URL的长度可以达到500字节，字符数没有限制。
NSString *userAvatarUrl = @"";

[zim updateUserAvatarUrl callback:^(NSString * _Nonnull userAvatarUrl, ZIMError * _Nonnull errorInfo) {
        
}];

1

Copied!

Example

// 修改用户名
// userAvatarUrl 是一个最多500字节的字符串，没有特殊字符限制。
try {
    ZIMUserAvatarUrlUpdatedResult result =
        await ZIM.getInstance()!.updateUserAvatarUrl('userAvatarUrl');
        // 在这里编写成功修改的逻辑
    } on PlatformException catch (onError) {
        // 根据 onError 编写并修改失败的逻辑
    }

1

Copied!

Example

// URL最大长度为500字节，没有特殊字符限制
std::string user_avatar_url = "";

zim_->updateUserAvatarUrl(user_avatar_url, [=](const std::string &userAvatarUrl, zim::ZIMError error_info){
    if (errorInfo.code == ZIM_ERROR_CODE_SUCCESS) {
         // 操作成功
    }
});

1

Copied!

Example

// URL最大长度为500字节，没有特殊字符限制
var userAvatarUrl = 'https://xxxx';

zim.updateUserAvatarUrl(userAvatarUrl)
    .then(function ({ userAvatarUrl }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

// URL最大为500字节，没有特殊字符限制
var userAvatarUrl = 'https://xxxx';

zim.updateUserAvatarUrl(userAvatarUrl)
    .then(function ({ userAvatarUrl }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

// URL最大为500字节，没有特殊字符限制
string userAvatarUrl = "xxx";
ZIM.GetInstance().UpdateUserAvatarUrl(userAvatarUrl, (string userAvatarUrl, ZIMError errorInfo) => {
    if(errorInfo.code == ZIMErrorCode.Success) {
        // 操作成功
    }
});

1

Copied!

Example

// 查询用户信息

// 使用限制：单次调用接口，查询 UserID 不能超过 10 个；在 10 秒内，多次调用接口查询的 UserID 累计总数不能超过 10 个。
ArrayList<String> userIDList = new ArrayList<>();
userIDList.add("user_id_1");

ZIMUsersInfoQueryConfig config = new ZIMUsersInfoQueryConfig();
config.isQueryFromServer = false;

zim.queryUsersInfo(userIDList, config, new ZIMUsersInfoQueriedCallback() {
        @Override
        public void onUsersInfoQueried(ArrayList<ZIMUserFullInfo> userList, ArrayList<ZIMErrorUserInfo> errorUserList, ZIMError errorInfo) {
            if(errorInfo.code == ZIMErrorCode.SUCCESS) {
                 // 查询成功
            }
        }
});

1

Copied!

Example

// 查询用户信息。
// 限制：每次调用最多可以查询10个用户ID，或者在10秒内多次调用。
[self.zim queryUsersInfo:@[@"userID_1",@"userID_2"] callback:^(NSArray<ZIMUserFullInfo *> * _Nonnull userList, NSArray<ZIMErrorUserInfo *> * _Nonnull errorUserList, ZIMError * _Nonnull errorInfo) {
        
}];

1

Copied!

Example

// 查询用户信息
// 使用限制：单个 API 调用中的 UserID 查询数量不能超过 10；在 10 秒内，多个 API 调用中的 UserID 查询累计总数不能超过 10。
try {
    ZIMUserInfoQueryConfig config = ZIMUserInfoQueryConfig();
    config.isQueryFromServer = false; // 如果从服务器查询，请设置为 true；如果从本地数据查询，请设置为 false
    ZIMUsersInfoQueriedResult result =
        await ZIM.getInstance()!.queryUsersInfo(['userID_1', 'userID_2'], config);
        // 在此处编写成功查询的逻辑
    } on PlatformException catch (onError) {
        // 根据 onError 编写查询失败的逻辑
    }

1

Copied!

Example

// 查询用户信息
// 使用限制：单次调用接口查询的UserID数量不能超过10个；
// 在10秒内，多次调用接口查询的UserID累计总数不能超过10个。
std::string target_user_id = "user_id_1";

std::vector<std::string> user_id_list;
user_id_list.push_back(target_user_id);

zim::ZIMUsersInfoQueryConfig config;
// false表示本地查询，优先返回本地数据库中的数据。
// 如果本地数据库中没有相应的用户信息，并且未达到查询频率限制，则自动升级为从服务器查询。
// true表示服务器查询，优先从服务器获取用户信息。
// 当达到查询频率限制时，尚未从服务器查询的用户信息将尝试从本地数据库返回数据。
config.isQueryFromServer = false;

zim_->queryUsersInfo(user_id_list, config, [=](const std::vector<zim::ZIMUserFullInfo> &userList, const std::vector<zim::ZIMErrorUserInfo> &errorUserList, const ZIM::ZIMError &errorInfo) {
    if (errorInfo.code == ZIM_ERROR_CODE_SUCCESS) {
        // 查询成功
    }
});

1

Copied!

Example

// 限制：单个 API 调用中的 UserID 查询数量不能超过 10；在 10 秒内，所有 UserID 查询的累计总数不能超过 10。
var userIDs = ['id1', 'id2'];

zim.queryUsersInfo(userIDs, { isQueryFromServer: false })
    .then(function ({ userList, errorUserList }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

// 限制：单个 API 调用中的 UserID 查询数量不能超过 10；在 10 秒内，所有 UserID 查询的累计总数不能超过 10。
var userIDs = ['id1', 'id2'];

zim.queryUsersInfo(userIDs, { isQueryFromServer: false })
    .then(function ({ userList, errorUserList }) {
        // 操作成功
    })
    .catch(function (err) {
        // 操作失败
    });

1

Copied!

Example

// 限制：单个 API 调用中的 UserID 查询数量不能超过 10；在 10 秒内，所有 UserID 查询的累计总数不能超过 10。
List<string> userIDList = new List<string>();
userIDList.Add("user_id_1");
ZIMUsersInfoQueryConfig config = new ZIMUsersInfoQueryConfig();
ZIM.GetInstance().QueryUsersInfo(userIDList, config, (ZIMUserFullInfo[] userList, ZIMErrorUserInfo[] errorUserList, ZIMError errorInfo) => {
    if (errorInfo.code == ZIMErrorCode.Success)
    {
        // 操作成功
    }
});

1

Copied!

用户管理

功能简介

实现流程

用户扩展字段管理

修改用户名称

设置用户头像

查询用户信息