文档中心>多人音视频房间 SDK>更多特性>设置昵称、头像(全平台)

设置昵称、头像(全平台)

最近更新时间:2024-08-02 16:24:31

我的收藏
本文介绍如何在 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 和小程序端

操作流程

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







操作权限

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

示例代码

如您需要在您的项目中,自行修改以支持会中修改昵称的功能,可使用如下 TUIRoomEngine 接口:
Web&H5
Electron
小程序
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',
});