文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>实时音视频>多人会议（含 UI）>更多特性（TUIRoomKit）>设置昵称、头像（全平台）

设置昵称、头像（全平台）

最近更新时间：2025-10-21 15:56:11

我的收藏

本页目录：

本文介绍如何在 TUIRoomKit 中设置用户的头像和昵称。

设置头像、昵称

如果您需要自定义昵称或头像，可以使用如下接口进行更新：
Web&H5
Android
iOS
uni-app
Flutter
Electron
await TUIRoomEngine.setSelfInfo({ userName: 'jack', avatarUrl: 'http://xxx' });
TUIRoomEngine.setSelfInfo("userName", "avatarUrl", null);
import TUIRoomEngine

TUIRoomEngine.setSelfInfo(userName: "xxx", avatarUrl: "xxx") {
    print("setSelfInfo success")
} onError: { code, message in
    print("setSelfInfo failed, code:\\(code),message:\\(message)")
}
await TUIRoomEngine.setSelfInfo({ userName: 'jack', avatarUrl: 'http://xxx' });
import 'package:rtc_room_engine/rtc_room_engine.dart';

TUIRoomEngine.setSelfInfo("userName", "avatarURL");
await TUIRoomEngine.setSelfInfo({ userName: 'jack', avatarUrl: 'http://xxx' });
注意：
由于用户隐私限制，昵称和头像更新可能会有延迟。如您需要更高的实时性，可以使用会中修改昵称功能。

会中修改昵称

在会议中，参会人员可以实时修改自己的昵称，以方便在不同场景中展示不同的身份。修改后的昵称会即时生效，但仅限于当前会议。
说明：
会中改名特性需使用 TUIRoomKit v2.5.0 及以上版本，支持 Web、Electron、H5 和小程序端。v2.7.0 以上版本，额外支持 Android & iOS。

操作流程

1. 在TUIRoomKit内，会中点击底部工具栏成员管理 > 选中自己或需要改名的用户 > 更多 > 修改名称。
2. 弹窗中输入需要修改后的名称后，单击确定即可即时生效。
Web&Electron
H5&小程序
Android&iOS






修改名称
修改会中名称成功








操作权限

普通用户仅能修改自己的昵称。
房主或管理员可以修改自己或其他用户的昵称。

示例代码

如您需要在您的项目中，自行修改以支持会中修改昵称的功能，可使用如下 TUIRoomEngine 接口：
Web&H5
Electron
小程序
Android
iOS
const roomEngine = TUIRoomEngine.getInstance();
await roomEngine.changeUserNameCard({
  userId: 'user_1234',
  nameCard: 'jack',
});
const roomEngine = TUIRoomEngine.getInstance();
await roomEngine.changeUserNameCard({
  userId: 'user_1234',
  nameCard: 'jack',
});
const roomEngine = new TUIRoomEngine();
await roomEngine.changeUserNameCard({
  userId: 'user_1234',
  nameCard: 'jack',
});
String userId = "123456"; // 请替换"123456"
String name = "David";    // 请替换 "David" 为您要修改的名称。
TUIRoomEngine.sharedInstance().changeUserNameCard(userId, name, new TUIRoomDefine.ActionCallback() {
    @Override
    public void onSuccess() {
        // 修改名称成功回调
    }

    @Override
    public void onError(TUICommonDefine.Error error, String message) {
       // 修改名称失败回调
    }
});
Swift
OC
import RTCRoomEngine

private func changeUserNameCard() {
    let userId = "123456"   // 请替换 "123456" 为您的用户ID。
    let name = "David"      // 请替换 "David" 为您要修改的名称。
    TUIRoomEngine.sharedInstance().changeUserNameCard(userId: userId, nameCard: name) {
        print("changeUserNameCard success")
    } onError: { code, message in
        print("changeUserNameCard error, code:\\(code), message:\\(message)")
    }
}
#import "RTCRoomEngine/TUIRoomEngine.h"

- (void) changeUserNameCard {
    NSString *userId = @"123456";   // 请替换 "123456" 为您的用户ID。
    NSString *name = @"David";      // 请替换 "David" 为您要修改的名称。
    [[TUIRoomEngine sharedInstance] changeUserNameCard:userId nameCard:name onSuccess:^{
        NSLog(@"changeUserNameCard success");
    } onError:^(TUIError code, NSString * _Nonnull message) {
        NSLog(@"changeUserNameCard error, code:%ld, message: %@", (long)code, message);
    }];
}

中国站
目录