Roblox 플랫폼의 사용자와 관련된 쿼리를 처리하는 서비스입니다.
요약
메서드
사용자 이름과 표시 이름을 포함하는 사용자 정보 배열을 반환합니다.
속성
메서드
GetUserInfosByUserIdsAsync
이 함수를 사용하면 현재 DataModel 외부의 사용자에 대한 정보를 대량으로 요청할 수 있습니다. 입력과 출력 값은 모두 배열입니다.
- 반환 값 배열에서 사용자 정보 개체의 순서가 입력 매개변수 배열에서 보낸 순서와 일치하지 않을 수 있습니다.The order of the user info objects in the return value's array may not match the order of the UserIds sent in the input parameter's array.사용자 정보 개체의 Id 필드를 사용하여 출력 배열과 입력 배열을 식별하십시오.
- Roblox 사용자가 계정에 연결된 DisplayName 를 가지고 있지 않은 경우, 이 함수는 대신 정보 개체의 DisplayName 필드에서 사용자의 사용자 이름과 동일한 문자열을 반환합니다.사용자의 UserId 는 결코 변경되지 않지만, 사용자 이름이나 표시 이름을 변경할 수 있으므로 동일한 입력 UserIds 이 이러한 필드에 대해 하루에서 다른 문자열을 반환할 수 있습니다.
- Since GetUserInfosByUserIdsAsync() 외부 웹 요청을 수행하므로, 백엔드 서비스에 중단이 발생하면 결과가 나타나고 실패할 수 있습니다.이 메서드를 pcall()로 감싼 후 중단 시간을 적절하게 처리할 수 있는지 확인하십시오.
- 결과는 분당 250개로 제한되므로 HTTP 429 오류가 발생하면 나중에 다시 시도하십시오, 가능한 한 입력 배열의 UserIds 수를 줄이고, 메서드 호출 수를 줄이거나 둘 다.
단일 사용자 정보 개체의 서명은 다음과 같습니다: The signature of a singular user info object is:
<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>확인된 배지HasVerifiedBadge</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