UserService

この機能では、現在の DataModel 以外のユーザーに関する情報を一括でリクエストできます。入力と出力の値は両方とも配列です。

• 返却値の配列内のユーザー情報オブジェクトの順序と、入力パラメータの配列内で送信された UserIds の順序が一致しない場合があります。ユーザー情報オブジェクトの Id フィールドを使用して、入力アレイと出力アレイを識別する。
• リクエストアレイに含まれる UserIds の 1つまたは複数が無効である場合、リクエストされたユーザー情報オブジェクトが少なくなる可能性があります。例えば、マイナス数またはアカウントが付属しないユーザーIDです。すべての UserIds が無効である場合、ゼロの結果を持つ返答を受け取ることができます。
• Roblox ユーザーがアカウントに関連付けられた DisplayName を持っていない場合、この関数は代わりに情報オブジェクトの DisplayName フィールドでユーザーのユーザー名と同じ文字列を返します。ユーザーの UserId は決して変更されませんが、ユーザー名または表示名を変更する可能性があり、同じ入力 UserIds が、1日から別の日にこれらのフィールドに対して異なる文字列を返す可能性があります。
• Since GetUserInfosByUserIdsAsync() 外部の Web リクエストを作成するため、バックエンドサービスが中断を経験している場合、生成して失敗する可能性があります。このメソッドを 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>バッジを検証済みHasVerifiedBadge</code></td>

    <td>ブールン値</td>

    <td>ユーザーに関連する <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> 値。</td>
  </tr>
</tbody>

パラメータ

戻り値

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