UserService

Diese Funktion ermöglicht es Ihnen, Informationen über Benutzer außerhalb des aktuellen DataModel in der Masse anzufordern. Die Eingabe- und Ausgabe Werte sind beide Arrays.

• Die Reihenfolge der Benutzer-Info-Objekte im Rückgabeverwertung-Matrix kann nicht mit der Reihenfolge der UserIds , die in der Arraygesendet wurden, übereinstimmen. Verwenden Sie das Feld Id der Benutzer-Info-Objekte, um Ihre Eingabeverwertung-Matrix mit der Arrayzu identifizieren.
• Es ist möglich, weniger Benutzer-Info-Objekte zu erhalten, als angefordert, wenn eines oder mehrere der UserIds im Anfrage- Array ungültig sind, wie negative Zahlen oder Benutzer-IDs, die keine Konten mit ihnen verknüpfen. Es ist möglich, eine Antwort mit null Ergebnissen zu erhalten, wenn alle UserIds ungültig sind.
• Wenn ein Roblox-Benutzer kein DisplayName mit seinem Konto verknüpft hat, wird diese Funktion stattdessen die gleiche Anzeigenamewie der Benutzername in seinem Info-Objekt DisplayName zurückgeben. Während ein Benutzer의
• Da GetUserInfosByUserIdsAsync() eine externe Web-Anfrage macht, wird sie ausgegeben und kann fehlgeschlagen sein, wenn der Backend-Dienst Unterbrechungen erleidet. Stellen Sie sicher, dass Sie das Ausfallrisiko angemessen verwalten, indem Sie diese Methode mit einem pcall() wrappen.
• Ergebnisse sind auf 250 pro Minute begrenzt, so dass, wenn Sie einen HTTP-429-Fehler erhalten, versuchen Sie es später erneut, idealerweise nach Reduzierung der Anzahl von UserIds in Ihrem Array, Reduzierung der Menge von Methodenrufen oder beides.

Die Signatur eines einzelnen Benutzer-Info-Objekts ist:

<tbody>
  <tr>
    <td><code>ID-Nummer</code></td>
    <td>nummer</td>
    <td>Die <code>Class.Player.UserId|userId</code> mit dem Benutzer in Verbindung.</td>
  </tr>

  <tr>
    <td><code>Benutzername</code></td>
    <td>string</td>
    <td>Der Benutzername, der mit dem Benutzer verbunden ist.</td>
  </tr>

  <tr>
    <td><code>DisplayName</code></td>
    <td>string</td>
    <td>Die <code>Class.Player.DisplayName|DisplayName</code> mit dem Benutzer verbunden.</td>
  </tr>

  <tr>
    <td><code>HatVerifiedBadge</code></td>
    <td>boolean</td>
    <td>Der <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> Wert, der mit dem Benutzer verbunden ist.</td>
  </tr>
</tbody>

Parameter

Rückgaben

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