UserService
แสดงที่เลิกใช้งานแล้ว
*เนื้อหานี้แปลโดยใช้ AI (เวอร์ชัน Beta) และอาจมีข้อผิดพลาด หากต้องการดูหน้านี้เป็นภาษาอังกฤษ ให้คลิกที่นี่
บริการที่จัดการคำถามเกี่ยวกับผู้ใช้บนแพลตฟอร์ม Roblox
สรุป
วิธีการ
คืนค่าเป็นคอลเลกชันของข้อมูลผู้ใช้รวมถึงชื่อผู้ใช้และชื่อแสดงผล
คุณสมบัติ
วิธีการ
GetUserInfosByUserIdsAsync
ฟังก์ชันนี้ช่วยให้คุณสามารถขอข้อมูลเกี่ยวกับผู้ใช้นอกเหนือจากปัจจุบัน DataModel ในรูปแบบขนาดใหญ่ ค่าอินพุตและค่าเอาต์พุตเป็นทั้งค่าอาร์เรย์
- ลำดับของวัตถุข้อมูลผู้ใช้ในค่ากลับของแอร์ราย์อาจไม่ตรงกับลำดับของ UserIds ที่ส่งในค่าพารามิเตอร์อินพุตใช้ฟิลด์ Id ของข้อมูลผู้ใช้เพื่อระบุอาร์เรย์อินพุตกับอาร์เรย์เอาต์พุต
- หากผู้ใช้ 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>
กุญแจ |
---|
พารามิเตอร์
ส่งค่ากลับ
ชุดของวัตถุสารานุกรมที่มีข้อมูลผู้ใช้
ตัวอย่างโค้ด
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