UserService

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Layanan

Layanan yang menangani pengguna di platform Roblox.

Properti

Metode

GetUserInfosByUserIdsAsync

Hasil

Fungsi ini memungkinkan Anda meminta informasi tentang pengguna di luar Class.DataModel saat ini dalam jumlah besar.Nilai masuk dan keluar adalah kedua array.

  • Urutan objek informasi pengguna dalam array nilai kembalian mungkin tidak cocok dengan urutan UserIds yang dikirim dalam array parameter input. Gunakan bidang Id dari objek informasi pengguna untuk mengidentifikasi array input Anda dengan array keluaran.
  • Mungkin untuk menerima lebih sedikit objek informasi pengguna yang diminta jika salah satu atau lebih dari UserIds dalam array permintaan tidak valid, seperti angka negatif atau ID pengguna yang tidak memiliki akun yang terkait dengan mereka. Mungkin untuk menerima jawaban dengan hasil nol jika semua Class.Player.UserId|UserIds
  • Jika pengguna Roblox tidak memiliki DisplayName yang terkait dengan akun mereka, fungsi ini kemudian akan mengembalikan string yang sama seperti nama pengguna pengguna dalam objek informasi mereka's <
  • Karena GetUserInfosByUserIdsAsync() membuat permintaan web eksternal, itu akan menghasilkan dan mungkin gagal jika layanan backend mengalami interrupsi. Pastikan Anda dapat menangani waktu pemutakhiran dengan benar dengan menyelubung metode ini dengan pcall() .
  • Hasilnya terbatas hanya 250 per menit, jadi jika Anda menerima kesalahan HTTP 429, coba lagi nanti, idealnya setelah mengurangi jumlah UserIds di input Anda, mengurangi jumlah panggilan metode, atau keduanya.

Tanda dari objek informasi pengguna tunggal adalah:


<tbody>
<tr>
<td><code>Id.</code></td>
<td>nomor</td>
<td>Class.Player.UserId|UserId|</td>
</tr>
<tr>
<td><code>Nama Pengguna</code></td>
<td>string</td>
<td>Nama pengguna yang dikaitkan dengan pengguna.</td>
</tr>
<tr>
<td><code>Nama Layar</code></td>
<td>string</td>
<td>Class.Player.DisplayName|DisplayName | yang terkait dengan pengguna.</td>
</tr>
<tr>
<td><code>Telah Verifikasi Badge</code></td>
<td>boolean</td>
<td>Nilai <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> yang dikaitkan dengan pengguna.</td>
</tr>
</tbody>
KunciJenisDeskripsi

Parameter

userIds: Array

Sebuah matriks UserIds yang diminta.


Memberikan nilai

Sebuah array objek kamus yang mengandung informasi pengguna.

Contoh Kode

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

Acara