Roblox 플랫폼의 사용자에 대한 쿼리를 처리하는 서비스입니다.
요약
메서드
사용자 이름과 표시 이름을 포함한 사용자 정보 배열을 반환합니다.
속성
메서드
GetUserInfosByUserIdsAsync
이 함수는 현재 DataModel 외부의 사용자에 대한 정보를 대량으로 요청할 수 있습니다. 입력 및 출력 값은 모두 배열입니다.
- 반환 값의 배열에 있는 사용자 정보 개체의 순서가 UserIds 를 보낸 입력 매개 변수의 배열과 일치하지 않을 수 있습니다. 사용자 정보 개체의 Id 필드를 사용하여 입력 배열을 출력 배열과 식별합니다.
- Roblox 사용자가 계정에 연결된 DisplayName이 없으면 이 함수는 사용자의 계정에 있는 사용자 표시 이름동일한 문자열을 반환합니다. 사용자의 계정에 있
- Class.UserService:GetUserInfosByUserIdsAsync()|GetUserInfosByUserIdsAsync() 는 외부 웹 요청을 만들므로 백엔드 서비스가 중단되면 생성되지 않고 실패할 수 있습니다. 이 메서드를 pcall() 와 함께 래핑하여 적절하게 대처할 수 있도록
- 결과는 분당 250개로 제한되므로 입력 배열에서 UserIds 를 줄이는 등 메서드 호출 수를 줄이거나 모두 줄이는 등 방법을 사용하여 결과를 제한하는 것이 좋습니다.
싱글 사용자 정보 개체의 서명은 다음과 같습니다.
<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>
키 | 유형 | 설명 |
---|
매개 변수
Class.Player.UserId|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