UserService

사용되지 않는 항목 표시

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

만들 수 없음
서비스

Roblox 플랫폼의 사용자에 대한 쿼리를 처리하는 서비스입니다.

속성

메서드

GetUserInfosByUserIdsAsync

생성

이 함수는 현재 DataModel 외부의 사용자에 대한 정보를 대량으로 요청할 수 있습니다. 입력 및 출력 값은 모두 배열입니다.

  • 반환 값의 배열에 있는 사용자 정보 개체의 순서가 UserIds 를 보낸 입력 매개 변수의 배열과 일치하지 않을 수 있습니다. 사용자 정보 개체의 Id 필드를 사용하여 입력 배열을 출력 배열과 식별합니다.
  • 요청 배열에 있는 하나 이상의 UserIds 가 유효하지 않은사용자 정보 개체를 더 적게 받을 수 있습니다. 모든 UserIds 가 유효하지 않은응답을 0개로 받습니다.
  • 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>
유형설명

매개 변수

userIds: Array

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

이벤트