处理 Roblox 平台上用户相关查询的服务。
概要
方法
返回包含用户名和显示名称的用户信息阵列。
属性
方法
GetUserInfosByUserIdsAsync
这个函数可以让你批量地请求当前 DataModel 之外的用户的信息。输入和输出值都是阵列。
- 返回值阵列中用户信息对象的顺序可能不与输入参数阵数组中发送的 UserIds 顺序匹配。使用用户信息对象的 Id 字段来识别输入阵列与输出阵数组。
- 如果 Roblox 用户没有与其帐户关联的 DisplayName,该函数会返回信息对象的 DisplayName 字段中与用户名相同的字符串。虽然用户的 UserId 永远不会改变,但他们可能会更改他们的用户名或昵称,因此同一输入 UserIds 可能会在一天到另一天之间为这些字段返回不同的字符串。
- 由于 GetUserInfosByUserIdsAsync() 发出外部网络请求,如果后端服务遇到中断,它将产生并可能失败。确保您可以适当地处理停机时间,通过包装此方法与 pcall() 来实现。
- 结果受到每分钟 250 的限制,因此如果您收到 HTTP 429 错误,请稍后再试,最好在减少输入阵数组中的 UserIds 数量、减少方法调用数量或两者都之后尝试。
单个用户信息对象的签名是:
<th>类型</th><th>描述</th></tr></thead><tbody><tr><td><code>Id</code></td><td>数字</td><td>与用户相关的 <code>Class.Player.UserId|UserId</code> 。</td></tr><tr><td><code>用户名</code></td><td>字符串</td><td>与用户关联的用户名。</td></tr><tr><td><code>显示名称</code></td><td>字符串</td><td>与用户相关的 <code>Class.Player.DisplayName|DisplayName</code> 。</td></tr><tr><td><code>已验证徽章</code></td><td>boolean 类型</td><td>与用户相关的 <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> 值。</td></tr></tbody>
关键 |
---|
参数
返回
包含用户信息的一组词典对象。
代码示例
UserService:GetUserInfosByUserIdsAsync Example
local UserService = game:GetService("UserService")
local success, result = pcall(function()
return UserService:GetUserInfosByUserIdsAsync({ 156, 1, 735878936 })
end)
if success then
for _, userInfo in ipairs(result) do
print("Id:", userInfo.Id)
print("Username:", userInfo.Username)
print("DisplayName:", userInfo.DisplayName)
end
else
-- An error occurred
end