setSelfInfo

功能介绍

说明

修改当前登录用户的个人信息。包含Ex字段。

注意

相关回调:
onSelfInfoUpdated

iOS

函数原型

  Future<String?> setSelfInfo({
    String? nickname,
    String? faceURL,
    int? globalRecvMsgOpt,
    String? ex,
    String? operationID,
  })

输入参数

参数名称	参数类型	是否必填	描述
nickname	String?	否	用户昵称
faceURL	String?	否	用户头像URL
globalRecvMsgOpt	int?	否	全局接收离线推送设置
ex	String?	否	扩展信息

返回结果

参数名称	参数类型	描述
~	~	无异常抛出则修改成功

代码示例

   await OpenIM.iMManager.userManager.setSelfInfo(
      nickname: 'lucy',
    );
    // todo

Android

函数原型

- (void)setSelfInfo:(OIMUserInfo *)userInfo
          onSuccess:(OIMSuccessCallback)onSuccess
          onFailure:(OIMFailureCallback)onFailure;

输入参数

参数名称	参数类型	是否必填	描述
userInfo	OIMUserInfo	是	用户相关信息

返回结果

参数名称	参数类型	描述
onSuccess	OIMSuccessCallback	成功返回
onFailure	OIMFailureCallback	失败返回

代码示例

OIMUserInfo *info = [OIMUserInfo new];
info.nickname = @"";
info.faceURL = @"";

[OIMManager.manager setSelfInfo:info
                      onSuccess:^(NSString * _Nullable data) {
} onFailure:^(NSInteger code, NSString * _Nullable msg) {
}];

Flutter

函数原型

 public void setSelfInfo(OnBase<String> base, UserInfoReq userInfoReq)

输入参数

请求结构体UserInfoReq属性如下所示：

参数名称	参数类型	是否必填	描述
userID	String	是	用户id
nickname	String	否	用户昵称
faceURL	String	否	用户头像
ex	String	否	扩展参数
globalRecvMsgOpt	Integer	否	全局免打扰，1:屏蔽消息; 2:接收消息但不提示; 0:正常

返回结果

代码示例

OpenIMClient.getInstance().userInfoManager.setSelfInfo(new OnBase<String>(){
    @Override
    public void onError(int code, String error) {
      // todo: 处理错误信息
    }
    @Override
    public void onSuccess(String data) {
      // todo: 请求成功
    }
},userInfoReq);

uni-app

函数原型

IMSDK.setSelfInfo(userInfo: Partial<Omit<SelfUserInfo, 'userID'>>, operationID?: string): Promise<WsResponse>

输入参数

参数名称	参数类型	是否必填	描述
userInfo	Partial<Omit<SelfUserInfo, 'userID'>>	是	个人信息

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<WsResponse>	调用成功回调
Promise.catch()	Promise<WsResponse>	调用失败回调

代码示例

import { getSDK } from '@openim/wasm-client-sdk';
const IMSDK = getSDK();

// use in electron with ffi
// import { getWithRenderProcess } from '@openim/electron-client-sdk/lib/render';
// const { instance: IMSDK } = getWithRenderProcess();

// use in mini program
// import { OpenIMSDK } from 'open-im-sdk';
// const IMSDK = new OpenIMSDK();

const userInfo = {
  nickname: '', // 要修改的昵称，选填
  faceURL: '', // 要修改的头像，选填
  ex: '', // 要修改的扩展字段内容，选填
};
IMSDK.setSelfInfo(userInfo)
  .then(() => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Browser/Electron/MiniProgram

函数原型

IMSDK.asyncApi('setSelfInfo', operationID: string, userInfo: Partial<Omit<SelfUserInfo, 'userID'>>): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数
userInfo	Partial<Omit<SelfUserInfo, 'userID'>>	是	个人信息

返回结果

通过openim-uniapp-polyfill包将函数 Promise 化，调用时需要使用then和catch判断并处理成功和失败回调。

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import IMSDK from 'openim-uniapp-polyfill';

const userInfo = {
  nickname: '', // 要修改的昵称，选填
  faceURL: '', // 要修改的头像，选填
  ex: '', // 要修改的扩展字段内容，选填
};
IMSDK.asyncApi('setSelfInfo', IMSDK.uuid(), userInfo)
  .then(() => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

React-Native

函数原型

OpenIMSDKRN.setSelfInfo(
  userInfo: Partial<Omit<SelfUserInfo, 'userID'>>,
  operationID: string
): Promise<void>

输入参数

参数名称	参数类型	是否必填	描述
userInfo	Partial<Omit<SelfUserInfo, 'userID'>>	是	个人信息
operationID	string	是	操作 ID，用于定位问题，保持唯一，建议用当前时间和随机数

返回结果

参数名称	参数类型	描述
Promise.then()	Promise<void>	调用成功回调
Promise.catch()	Promise<CatchResponse>	调用失败回调

代码示例

import OpenIMSDKRN from "open-im-sdk-rn";

const userInfo = {
  nickname: '', // 要修改的昵称，选填
  faceURL: '', // 要修改的头像，选填
  ex: '', // 要修改的扩展字段内容，选填
};

OpenIMSDKRN.setSelfInfo(userInfo, 'operationID');
  .then(() => {
    // 调用成功
  })
  .catch(({ errCode, errMsg }) => {
    // 调用失败
  });

Unity

函数原型

public static void SetSelfInfo(onBase<bool> cb, UserInfo userInfo)

输入参数

参数名称	参数类型	是否必填	描述
cb	OnBase	是	回调
userInfo	UserInfo	是	名字

返回结果

代码示例

IMSDK.SetSelfInfo((suc,errCode,errMsg)=>{

},userInfo);