UserService

사용되지 않는 항목 표시

*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

만들 수 없음
서비스

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 필드를 사용하여 출력 배열과 입력 배열을 식별하십시오.
  • 요청 배열에 있는 UserIds 중 하나 이상이 무효하거나 부정 숫자 또는 계정과 연결되지 않은 사용자 ID와 같이 요청된 사용자 정보 개체가 줄어들 수 있으므로 요청된 정보보다 적은 수의 사용자 정보 개체를 받을 수 있습니다.모든 UserIds가 무효하면 0개의 결과로 응답을 받을 수 있습니다.
  • 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>

매개 변수

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

이벤트