UserService

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Assistenza

Un servizio che gestisce le richieste riguardanti gli utenti sulla PiattaformaRoblox.

Proprietà

Metodi

GetUserInfosByUserIdsAsync

Resa

Questa funzione ti consente di richiedere informazioni sugli utenti al di fuori del DataModel attuale in modo da poterlo fare in massa. Gli input e gli output sono entrambi阵.

  • L'ordine degli oggetti informazioni dell'utente nell' array restituisce potrebbe non corrispondere all'ordine degli UserIds inviati nell' input parametri's vettore. Usa il campo Id dell' oggetto informazioni dell'utente per identificare il tuo array di input con l' vettoredi uscita.
  • È possibile ricevere meno oggetti di informazioni utente richiesti se uno o più dei UserIds in richiesta sono Non valido, come i numeri negativi o gli ID utente che non hanno account associati con loro. È possibile ricevere una risposta con zero risultati se tutti UserIds sono Non valido.
  • Se un utente Roblox non ha un DisplayName associato al suo Account, questa funzione restituirà invece lo stesso valore come l'username dell'utente nel campo DisplayName del loro oggetto Nome Visualizzato. Mentre il valore Class.Player.UserId
  • Poiché GetUserInfosByUserIdsAsync() rende una Richiestaweb esterna, producirà e potrebbe fallire se il servizio di backend sta riscontrando interruzioni. Assicurati di poter gestire in modo appropriato il tempo di ripristino con un pcall() .
  • I risultati sono limitati a 250 per minuto, quindi se ricevi un errore HTTP 429, riprova più tardi, in genere dopo aver ridotto il numero di UserIds nell' vettoredi input, riducendo il numero di chiamate di metodo o entrambi.

La firma di un singolo oggetto informazioni utente è:


<tbody>
<tr>
<td><code>Id ×1</code></td>
<td>number</td>
<td>Il <code>Class.Player.UserId|userId</code> associato all'utente.</td>
</tr>
<tr>
<td><code>Nome utente</code></td>
<td>stringa</td>
<td>Il nome utente associato all'utente.</td>
</tr>
<tr>
<td><code>Nome visualizzato</code></td>
<td>stringa</td>
<td>Il <code>Class.Player.DisplayName|DisplayName</code> associato all'utente.</td>
</tr>
<tr>
<td><code>Badge con verifica has.</code></td>
<td>booleano</td>
<td>Il valore <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> associato all'utente.</td>
</tr>
</tbody>
ChiaveTipoDescrizione

Parametri

userIds: Array

Un array di UserIds richiesto.


Restituzioni

Un insieme di oggetti di dizionario che contiene informazioni dell'utente.

Campioni di codice

UserService:GetUserInfosByUserIdsAsync Example

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

Eventi