UserService

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

无法创建
服务

处理 Roblox 平台上用户相关查询的服务。

属性

方法

GetUserInfosByUserIdsAsync

暂停

这个函数可以让你批量地请求当前 DataModel 之外的用户的信息。输入和输出值都是阵列。

  • 返回值阵列中用户信息对象的顺序可能不与输入参数阵数组中发送的 UserIds 顺序匹配。使用用户信息对象的 Id 字段来识别输入阵列与输出阵数组。
  • 如果请求阵列中的 UserIds 中有一个或多个无效,例如负数或没有与其关联的用户 ID 的用户信息对象,那么可能会收到较少的用户信息对象,而不是请求的数量。如果所有 UserIds 无效,可能会收到零结果的响应。
  • 如果 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>
关键

参数

userIds: Array

请求了一个 UserIds 阵列。

默认值:""

返回

包含用户信息的一组词典对象。

代码示例

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

活动