UserService

Chức năng này cho phép bạn yêu cầu thông tin về người dùng bên ngoài hiện tại DataModel trong lượng lớn. Giá trị nhập và xuất đều là mảng.

• Thứ tự của các đối tượng thông tin người dùng trong mảng giá trị trả về có thể không phù hợp với thứ tự của UserIds được gửi trong mảng tham số nhập.Sử dụng trường Id của đối tượng thông tin người dùng để xác định mảng nhập với mảng xuất.
• Bạn có thể nhận ít đối tượng thông tin người dùng hơn yêu cầu nếu một hoặc nhiều UserIds trong mảng yêu cầu không hợp lệ, chẳng hạn như số âm hoặc ID người dùng không có tài khoản liên quan đến chúng.Bạn có thể nhận được một phản hồi với không có kết quả nếu tất cả UserIds không hợp lệ.
• Nếu người dùng Roblox không có một DisplayName liên quan đến tài khoản của họ, chức năng này sẽ thay vào đó trả về chuỗi tương tự như tên người dùng của người dùng trong trường DisplayName của đối tượng thông tin của họ.Trong khi địa chỉ UserId của người dùng sẽ không bao giờ thay đổi, họ có thể thay đổi tên người dùng hoặc tên hiển thị, do đó cùng một đầu vào UserIds có thể trả về một chuỗi khác cho các trường này từ một ngày này sang ngày khác.
• Vì GetUserInfosByUserIdsAsync() tạo một yêu cầu web bên ngoài, nó sẽ cho ra và có thể thất bại nếu dịch vụ backend bị gián đoạn.Hãy chắc chắn rằng bạn có thể xử lý thời gian chết một cách thích hợp bằng cách bọc phương pháp này với một pcall() .
• Kết quả được giới hạn ở 250 mỗi phút, vì vậy nếu bạn nhận được lỗi HTTP 429, hãy thử lại sau, lý tưởng là sau khi giảm số UserIds trong array nhập của bạn, giảm số lượng cuộc gọi phương thức, hoặc cả hai.

Chữ ký của một đối tượng thông tin người dùng đơn là:

<th>Loại</th>

    <th>Mô tả</th>
  </tr>
</thead>

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

    <td>số</td>

    <td>Các lớp <code>Class.Player.UserId|UserId</code> liên quan đến người dùng.</td>
  </tr>

  <tr>
    <td><code>Tên người dùng</code></td>

    <td>chuỗi</td>

    <td>Tên người dùng liên quan đến người dùng.</td>
  </tr>

  <tr>
    <td><code>Tên hiển thị</code></td>

    <td>chuỗi</td>

    <td>Các lớp <code>Class.Player.DisplayName|DisplayName</code> liên quan đến người dùng.</td>
  </tr>

  <tr>
    <td><code>HasVerifiedBadge đã được xác minh</code></td>

    <td>boolean như vậy</td>

    <td>Giá trị <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> liên quan đến người dùng.</td>
  </tr>
</tbody>

Tham Số

Lợi Nhuận

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