UserService

這個功能讓你能夠在一次請求中大量要求現有的 DataModel 之外的使用者資訊。輸入和輸出值都是陣列。

• 返回值的 array 中的使用者資訊對象的順序可能與輸入參數 arra陣列 中傳送的 UserIds 順序不匹配。使用使用者資訊對象的 Id 欄位來識別您的輸入數組與輸出數陣列。
• 如果要求中的 UserIds 中有一個或多個無效，例如負數或沒有與它們相關的帳戶的使用者資訊對象，那麼可能會收到少於要求的使用者資訊對象。如果所有 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>

參數

返回

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