UserService

Fungsi ini memungkinkan Anda untuk meminta informasi tentang pengguna di luar DataModel saat ini dalam jumlah banyak. Nilai input dan output adalah kedua array.

• Urutan objek informasi pengguna dalam array nilai pengembalian 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 output.
• Dimungkinkan untuk menerima lebih sedikit objek informasi pengguna yang diminta daripada yang diminta jika satu atau lebih dari UserIds dalam array permintaan tidak valid, seperti angka negatif atau ID pengguna yang tidak memiliki akun yang terkait dengannya.Dimungkinkan untuk menerima respons dengan hasil nol jika semua UserIds tidak valid.
• Jika pengguna Roblox tidak memiliki DisplayName yang terkait dengan akun mereka, fungsi ini akan kembali string yang sama dengan nama pengguna pengguna di bidang DisplayName objek informasi mereka.Sementara UserId pengguna tidak akan pernah berubah, mereka dapat mengubah nama displaypengguna atau nama tampilan, sehingga input yang sama UserIds mungkin menampilkan string yang berbeda untuk bidang ini dari satu hari ke hari berikutnya.
• Karena GetUserInfosByUserIdsAsync() membuat permintaan web eksternal, itu akan menghasilkan dan mungkin gagal jika layanan backend mengalami gangguan.Pastikan Anda dapat menangani downtime dengan tepat dengan melapisi metode ini dengan pcall().
• Hasil terbatas pada 250 per menit, jadi jika Anda menerima kesalahan HTTP 429, coba lagi nanti, idealnya setelah mengurangi jumlah UserIds dalam array input Anda, mengurangi jumlah panggilan metode, atau keduanya.

Tanda tangan dari objek informasi pengguna tunggal adalah:

<th>Jenis</th>

    <th>Deskripsi</th>
  </tr>
</thead>

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

    <td>angka</td>

    <td>Kelas <code>Class.Player.UserId|UserId</code> yang terkait dengan pengguna.</td>
  </tr>

  <tr>
    <td><code>Nama pengguna</code></td>

    <td>string</td>

    <td>Nama pengguna yang terkait dengan pengguna.</td>
  </tr>

  <tr>
    <td><code>Nama Tampilan</code></td>

    <td>string</td>

    <td>Kelas <code>Class.Player.DisplayName|DisplayName</code> yang terkait dengan pengguna.</td>
  </tr>

  <tr>
    <td><code>Lencana Terverifikasi</code></td>

    <td>boolean</td>

    <td>Nilai <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> yang terkait dengan pengguna.</td>
  </tr>
</tbody>

Parameter

Memberikan nilai

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