UserService

此功能允許您在當前的 DataModel 外的用戶提出資訊。輸入和輸出值都是陣列。

• 將返回值的陣列中的用戶資訊對象的順序與輸入參數的陣列的順序不匹配。使用用戶資訊對象的 UserIds 字段來識別輸入參數的陣列與輸出參數的陣列。
• 如果要求資料集中的 UserIds 中的一個或多個為無效，如果要求集中的所有 UserIds 為無效，或者要求集中的所有 Class.Player.UserId|UserIds 為無效，將能獲得與此無關的結果。
• 如果 Roblox 用戶沒有與帳號屬性相關的 DisplayName，此功能將會返回同一個字串作為用戶的帳號顯示名稱稱在其資訊對物件的 DisplayName 字段。雖然用戶的 <
• 因為 GetUserInfosByUserIdsAsync() 會發生外部網路請邀請，因此會產生並可能發生暫時關閉，請確保您可以正確處理暫時關閉。將此方法包含在 pcall() 中。
• 結果每分鐘限制為 250 個，因此如果您收到 HTTP 429 錯誤，請稍後再試，通常在減少輸入陣列中的 UserIds 數量，減少方法呼叫或兩者的數量。

單一使用者資訊對象的簽名是：

<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