UserService

แสดงที่เลิกใช้งานแล้ว

*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่

ไม่สามารถสร้าง
บริการ

บริการที่จัดการคำถามเกี่ยวกับผู้ใช้บนแพลตฟอร์ม Roblox

สรุป

วิธีการ

  • ผลตอบแทน

    คืนค่าเป็นคอลเลกชันของข้อมูลผู้ใช้รวมถึงชื่อผู้ใช้และชื่อแสดงผล

คุณสมบัติ

วิธีการ

GetUserInfosByUserIdsAsync

ผลตอบแทน

ฟังก์ชันนี้ช่วยให้คุณสามารถขอข้อมูลเกี่ยวกับผู้ใช้นอกเหนือจากปัจจุบัน DataModel ในรูปแบบขนาดใหญ่ ค่าอินพุตและค่าเอาต์พุตเป็นทั้งค่าอาร์เรย์

  • ลำดับของวัตถุข้อมูลผู้ใช้ในค่ากลับของแอร์ราย์อาจไม่ตรงกับลำดับของ UserIds ที่ส่งในค่าพารามิเตอร์อินพุตใช้ฟิลด์ Id ของข้อมูลผู้ใช้เพื่อระบุอาร์เรย์อินพุตกับอาร์เรย์เอาต์พุต
  • เป็นไปได้ที่จะได้รับข้อมูลผู้ใช้น้อยกว่าที่ร้องขอหากหนึ่งหรือมากกว่า UserIds ในคลังข้อมูลคำขอไม่ถูกต้อง เช่น ตัวเลขลบหรือรหัสผู้ใช้ที่ไม่มีบัญชีที่เกี่ยวข้องเป็นไปได้ที่จะได้รับคำตอบที่มีผลลัพธ์เป็นศูนย์หากทั้งหมด UserIds ไม่ถูกต้อง
  • หากผู้ใช้ Roblox ไม่มี DisplayName ที่เกี่ยวข้องกับบัญชีของตน ฟังก์ชันนี้จะแทนที่ด้วยสตริงเดียวกันกับชื่อผู้ใช้ในฟิลด์ DisplayName ของวัตถุข้อมูลของผู้ใช้ในขณะที่ผู้ใช้ UserId จะไม่เปลี่ยนแปลง พวกเขาอาจเปลี่ยนชื่อผู้ใช้หรือชื่อแสดง ดังนั้นการใส่เดียวกัน UserIds อาจส่งคืนสตริงที่แตกต่างสำหรับฟิลด์เหล่านี้จากวันหนึ่งไปอีกวันหนึ่ง
  • เนื่องจาก GetUserInfosByUserIdsAsync() สร้างคำขอเว็บภายนอกจึงจะเกิดขึ้นและอาจล้มเหลวหากบริการด้านหลังได้รับการขัดขวางตรวจสอบให้แน่ใจว่าคุณสามารถจัดการเวลาหยุดทำงานได้อย่างเหมาะสมโดยการห่อวิธีนี้ด้วย pcall()
  • ผลลัพธ์จะจํากัดอยู่ที่ 250 ต่อนาทีดังนั้นหากคุณได้รับข้อผิดพลาด HTTP 429 ลองอีกครั้งในภายหลังหลังจากลดจํานวน UserIds ในอาร์เรย์อินพุตของคุณลดจํานวนการเรียกวิธีหรือทั้งสองอย่าง

ลายเซ็นของวัตถุข้อมูลผู้ใช้เดียวคือ:


<th>ประเภท</th>
<th>คําอธิบาย</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Id</code></td>
<td>จํานวน</td>
<td>คลาส <code>Class.Player.UserId|UserId</code> ที่เชื่อมโยงกับผู้ใช้</td>
</tr>
<tr>
<td><code>ชื่อผู้ใช้</code></td>
<td>สตริง</td>
<td>ชื่อผู้ใช้ที่เกี่ยวข้องกับผู้ใช้</td>
</tr>
<tr>
<td><code>ชื่อที่แสดง</code></td>
<td>สตริง</td>
<td>คลาส <code>Class.Player.DisplayName|DisplayName</code> ที่เกี่ยวข้องกับผู้ใช้</td>
</tr>
<tr>
<td><code>มีตราสัญลักษณ์ที่ได้รับการยืนยัน</code></td>
<td>เป็นไปได้</td>
<td>ค่า <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> ที่เกี่ยวข้องกับผู้ใช้</td>
</tr>
</tbody>
กุญแจ

พารามิเตอร์

userIds: Array

เป็นชุดของ UserIds ที่ร้องขอ

ค่าเริ่มต้น: ""

ส่งค่ากลับ

ชุดของวัตถุสารานุกรมที่มีข้อมูลผู้ใช้

ตัวอย่างโค้ด

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

เหตุการณ์