UserService

Funkcja ta pozwala na żądanie informacji o użytkownikach poza obecną DataModel w dużej ilości. Wartości wejściowe i wyjściowe są obie tablice.

• kolejność obiektów informacji użytkownika w wartości zwrotnej może nie pasować do kolejności UserIds wysłanych w parametrze wejściowym.Użyj pola Id z obiektu informacji o użytkowniku, aby zidentyfikować swój wejściowy array z wyjściowym array.
• Można otrzymać mniej obiektów informacji użytkownika niż wymagane, jeśli jeden lub więcej z UserIds w matrycy żądań jest nieważny, tak jak negatywne liczby lub identyfikatory użytkowników, które nie mają z nimi powiązanych kont.Można otrzymać odpowiedź bez wyników, jeśli wszystkie UserIds są nieprawidłowe.
• Jeśli użytkownik Roblox nie ma powiązanej z kontem DisplayName funkcji, ta funkcja zamiast tego zwróci tę samą strunę, jak nazwa użytkownika w polu DisplayName ich obiektu informacyjnego.Chociaż UserId użytkownika nigdy się nie zmieni, mogą zmienić swoją nazwę użytkownika lub nazwę wyświetlaną, więc ten sam input UserIds może wywrócić inną strunę dla tych pól z jednego dnia na drugi.
• Ponieważ GetUserInfosByUserIdsAsync() wysyła zewnętrzną prośbao stronę internetową, wygeneruje i może zawieść, jeśli tylny serwis doświadcza przerw.Upewnij się, że możesz odpowiednio obsłużyć czas przestoju, owijając tę metodę za pomocą pcall().
• Wyniki są ograniczone do 250 na minutę, więc jeśli otrzymasz błąd HTTP 429, spróbuj ponownie później, idealnie po zmniejszeniu liczby UserIds w swojej matrycy wejściowej, zmniejszeniu liczby wezwań metod lub obu.

Podpis obiektu informacji pojedynczego użytkownika jest:

<th>Typ</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Id</code></td>

    <td>number liczba</td>

    <td>Klasa <code>Class.Player.UserId|UserId</code> powiązana z użytkownikiem.</td>
  </tr>

  <tr>
    <td><code>Nazwa użytkownika</code></td>

    <td>ciąg</td>

    <td>Nazwa użytkownika powiązana z użytkownikiem.</td>
  </tr>

  <tr>
    <td><code>Nazwa wyświetlania</code></td>

    <td>ciąg</td>

    <td>Klasa <code>Class.Player.DisplayName|DisplayName</code> powiązana z użytkownikiem.</td>
  </tr>

  <tr>
    <td><code>Zdobyto certyfikat HasVerifiedBadge</code></td>

    <td>booleanowy</td>

    <td>Wartość <code>Class.Player.HasVerifiedBadge|HasVerifiedBadge</code> powiązana z użytkownikiem.</td>
  </tr>
</tbody>

Parametry

Zwroty

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