UserService
Visualizza obsoleti
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Un servizio che gestisce le richieste relative agli utenti sulla PiattaformaRoblox.
Sommario
Proprietà
Metodi
Restituisce un array di informazioni utente, tra cui il nome utente e il nome da mostrare.
Proprietà
Metodi
GetUserInfosByUserIdsAsync
Questa funzione ti consente di richiedere informazioni sugli utenti al di fuori dell'attuale DataModel in blocco. Gli input e gli output valori sono entrambi array.
- L'ordine degli oggetti di informazione dell'utente nell'array del valore di restituzione potrebbe non corrispondere all'ordine di UserIds inviato nell'vettoredel parametro di input.Usa il campo Id del oggetto informazioni utente per identificare il tuo array di input con l'vettoredi output.
- È possibile ricevere meno oggetti di informazione utente richiesti rispetto a quanto richiesto se uno o più dei UserIds nell'array di richiesta sono Non valido, come numeri negativi o ID utente che non hanno account associati.È 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 la stessa stringa come il nome utente dell'utente nel campo DisplayName del suo oggetto di informazione.Mentre il UserId di un utente non cambierà mai, possono cambiare il loro nome utente o il Nome Visualizzato, quindi lo stesso input UserIds può restituire una stringa diversa per questi campi da un giorno all'altro.
- Dal momento che GetUserInfosByUserIdsAsync() fa una Richiestaweb esterna, produrrà e potrebbe fallire se il servizio backend sta subendo interruzioni.Assicurati di poter gestire il tempo di inattività in modo appropriato avvolgendo questo metodo con un pcall() .
- I risultati sono limitati a 250 al minuto, quindi se ricevi un errore HTTP 429, riprova più tardi, idealmente dopo aver ridotto il numero di UserIds in vettoredi input, riducendo il numero di chiamate di metodo o entrambi.
La firma di un oggetto di informazioni singolo dell'utente è:
<th>Tipo</th><th>Descrizione</th></tr></thead><tbody><tr><td><code>Id</code></td><td>numbero</td><td>La <code>Class.Player.UserId|UserId</code> associata 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 da mostrare</code></td><td>stringa</td><td>Il <code>Class.Player.DisplayName|DisplayName</code> associato all'utente.</td></tr><tr><td><code>Badge Verificato</code></td><td>booleano</td><td>Il valore <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> associato all'utente.</td></tr></tbody>
Chiave |
---|
Parametri
Restituzioni
Un array di oggetti dizionario che contiene informazioni sull'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