UserService

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Oluşturulamaz
Hizmet

Roblox platformundaki kullanıcılar ile ilgili soruları ele alan bir hizmet.

Özellikler

Yöntemler

GetUserInfosByUserIdsAsync

Bekletir

Bu işlev, mevcut DataModel dışındaki kullanıcılar hakkında toplu olarak bilgi isteyebilmenizi sağlar. Giriş ve çıkış değerleri her ikisi de dizi.

  • Geri dönüş değerinin düzeninde kullanıcı bilgi nesnelerinin sırası, giriş parametre düzeninde gönderilen UserIds sırayla eşleşmeyebilir.Giriş düzeninizi çıktı düzeniyle tanımlamak için kullanıcı bilgi nesnesinin Id alanını kullanın.
  • İstek dizisindeki UserIds 'den biri veya daha fazlası geçersizse, talep edilen kullanıcı bilgi nesnelerinden daha azı alınabilir, örneğin negatif sayılar veya hesaplarıyla ilişkili olmayan kullanıcı kimlikleri gibi.Tüm UserIds geçersizse sıfır sonuçlu bir yanıt almak mümkündür, eğer tüm çalışmazsa.
  • Bir Roblox kullanıcısının hesapilişkili bir DisplayName ı yoksa, bu işlev yerine bilgi nesnesinin DisplayName alanındaki kullanıcının kullanıcı adıyla aynı dizeyi döndürecektir.Bir kullanıcının UserId ı asla değişmeyecek olsa da, kullanıcı adını veya görünen addeğiştirebilir, bu nedenle aynı giriş UserIds bir günden diğerine bu alanlar için farklı bir dize döndürebilir.
  • Çünkü GetUserInfosByUserIdsAsync() dış bir web talepyapar, arka plandaki hizmet kesintilere uğrarsa sonuç verecek ve başarısız olabilir.Bu yöntemi bir pcall() ile sarıp uygun şekilde kesintiye uğratabileceğinizden emin olun.
  • Sonuçlar dakika başına 250 ile sınırlıdır, bu nedenle bir HTTP 429 hatası alırsanız, daha sonra tekrar deneyin, ideal olarak giriş düzeninizdeki UserIds sayısını azaltarak, yöntem çağrılarını azaltarak veya her ikisini de azaltarak.

Tek bir kullanıcı bilgi nesnesinin imzası şöyledir:


<th>Tür</th>
<th>Açıklama</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Id</code></td>
<td>sayı</td>
<td>Kullanıcı ile ilişkili <code>Class.Player.UserId|UserId</code> , kullanıcı ile ilişkili</td>
</tr>
<tr>
<td><code>Kullanıcı adı</code></td>
<td>dizi</td>
<td>Kullanıcıyla ilişkili kullanıcı adı.</td>
</tr>
<tr>
<td><code>Görüntüleme Adı</code></td>
<td>dizi</td>
<td>Kullanıcıyla ilişkili <code>Class.Player.DisplayName|DisplayName</code> .</td>
</tr>
<tr>
<td><code>Doğrulanmış Başarım HasVerifiedBadge</code></td>
<td>boşluklı</td>
<td>Kullanıcı ile ilişkili <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> değeri.</td>
</tr>
</tbody>
Anahtar

Parametreler

userIds: Array

Bir UserIds dizi talep edildi.

Varsayılan değer: ""

Dönüşler

Kullanıcı bilgilerini içeren bir sözlük nesnesi dizi.

Kod Örnekleri

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

Etkinlikler