UserService

Diese Funktion ermöglicht es Ihnen, Informationen über Benutzer außerhalb der aktuellen DataModel im Massenverfahren anzufordern. Die Eingangs- und Ausgabewerte sind beide Arrays.

• Die Reihenfolge der Benutzerinformationsobjekte im Rückgabewert- Array kann nicht der Reihenfolge der UserIds im Eingabeparameter- Array entsprechen.Verwende das Feld Id des Benutzerinformationsobjekts, um deinen Eingabearray mit dem Ausgabearray zu identifizieren.
• Es ist möglich, weniger Benutzer-Info-Objekte als angefordert zu erhalten, wenn eines oder mehrere der UserIds im Anforderungsarray ungültig sind, wie negative Zahlen oder Benutzer-IDs, die keine Konten haben, die damit verbunden sind.Es ist möglich, eine Antwort mit null Ergebnissen zu erhalten, wenn alle UserIds ungültig sind.
• Wenn ein Roblox-Benutzer keine DisplayName mit seinem Konto verbundene Funktion hat, gibt diese Funktion stattdessen den gleichen String wie der Benutzername des Benutzers in seinem Info-Objekt-Feld DisplayName zurück.Während die UserId eines Benutzers sich nie ändern wird, können sie ihren Benutzernamen oder ihren Display-Namen ändern, so dass derselbe Eingabe UserIds einen anderen Text für diese Felder von einem Tag zum anderen zurückgeben kann.
• Da GetUserInfosByUserIdsAsync() eine externe Web-Anfrage auslöst, wird sie Ergebnisse liefern und möglicherweise fehlschlagen, wenn der Backend-Service Unterbrechungen erlebt.Stellen Sie sicher, dass Sie die Ausfallzeit angemessen handhaben können, indem Sie diese Methode mit einem pcall() umwickeln.
• Die Ergebnisse sind auf 250 pro Minute begrenzt, also wenn du eine HTTP-Fehler 429 erhältst, versuche es später erneut, idealerweise nach der Reduzierung der Anzahl von UserIds in deinem Array, der Reduzierung der Anzahl von Methode-Aufrufen oder beides.

Die Signatur eines einzelnen Benutzer-Info-Objekts ist:

<th>Typ</th>

    <th>Beschreibung</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Id</code></td>

    <td>zahl</td>

    <td>Die <code>Class.Player.UserId|UserId</code>, die mit dem Benutzer verbunden ist.</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>Anzeigename</code></td>

    <td>string</td>

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

  <tr>
    <td><code>HatVerifiedBadge</code></td>

    <td>boolesisch</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