Players
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
サービスには、現在接続されているクライアントに Roblox サーバーに接続するための オブジェクトが含まれています。また、場プレースの構成情報も含まれています。サーバーに接続していないプレイヤーに関する情報(キャラクターの外観、友達、アバターのサムネイルなど)を取得できます。
概要
プロパティ
禁止 API を構成する 3 つの Players メソッド ( BanAsync() , UnbanAsync() , GetBanHistoryAsync() ) を有効化または無効化します。このプロパティはスクリプト化できず、Studio でのみ変更できます。
バブルチャットが有効かどうかを示します。Players:SetChatStyle() メソッドで設定されます。
characters が自動的に再スポーンするかどうかを示します。
クラシックチャットが有効かどうかを示します; Players:SetChatStyle() メソッドによって設定されます。
The Player が実行しているのは、LocalScript です。
サーバーに入れることができる最大プレイヤー数。
サーバーのプレイヤー数の推奨数。
プレイヤーのキャラクターがリスポーンする時間量を制御します。
方法
ローカルプレイヤーが指定されたメッセージをチャットします。
返す の が指定されたインスタンスに一致するか、 が見つからない場合は、 。
現在接続されているすべての Player オブジェクトのテーブルを返します。
バブルチャットとクラシックチャットが使用されているかどうかを設定し、チームチャットと Chat に何をすべきかを伝えます。
ローカルプレイヤーが指定されたメッセージをチャットし、同じチームのユーザーにのみ表示されます。
期間、理由、禁止が全宇宙に適用されるか現在のプレース所のみに適用されるかなど、禁止ユーザーをエクスペリエンスから排除するオプションを提供します。このメソッドは、Players.BanningEnabled プロパティによって有効化および無効化され、Studio で切り替えることができます。
- CreateHumanoidModelFromDescription(description : HumanoidDescription,rigType : Enum.HumanoidRigType,assetTypeVerification : Enum.AssetTypeVerification):Model
パスされた HumanoidDescription に指定されたすべてを装備したキャラクターモデルを返し、rigType によって指定された R6 または R15 です。
パスされたユーザーのアバターに一致するように装備されたキャラクターモデル設定を返します。Returns a character Model set-up with everything equipped to match the avatar of the user specified by the passed in userId.
エクスペリエンスの宇宙内のユーザーの禁止と解除履歴を取得します。このメソッドは、Players.BanningEnabled プロパティによって有効化および無効化され、Studio で切り替えることができます。
特定のユーザーのキャラクターの外観情報を返します。
返す FriendPages オブジェクトには、指定されたプレイヤーの友達すべての情報が含まれています。
指定された衣装のヒューマノイド説明を返し、衣装のパーツ/カラー/アニメーションなどで設定されます。
パスされたユーザーのアバターに指定されたものすべてを装備する HumanoidDescription を返します。
指定された UserId のアカウントのユーザー名に関するクエリを Roblox ウェブサイトに送信します。
指定されたユーザーユーザーネームを持つアカウントの userId に対して、Roblox ウェブサイトにクエリを送信します。
- GetUserThumbnailAsync(userId : number,thumbnailType : Enum.ThumbnailType,thumbnailSize : Enum.ThumbnailSize):Tuple
サイズとタイプを指定して、プレイヤーのサムネイルのコンテンツ URLを返し、画像が使用できるかどうかを説明するボールーンを返します。
Players:BanAsync() またはユーザー制限オープンクラウド API から禁止されたプレイヤーを解除するこのメソッドは、Players.BanningEnabled プロパティによって有効化および無効化され、Studio で切り替えることができます。
イベント
プレイヤーがゲームに入ると発火します。
ゲームサーバーがプレイヤーのメンバーシップが変更されたことを認識したときに発火します。
プレイヤーがゲームを終了するときに発火します。
ゲームサーバーが、特定のサブスクリプションのユーザーのステータスが変更されたことを認識したときに発火します。
プロパティ
BanningEnabled
禁止 API を構成する 3 つの Players メソッド ( BanAsync() , UnbanAsync() , GetBanHistoryAsync() ) を有効化または無効化します。このプロパティはスクリプト化できず、Studio でのみ変更できます。
BubbleChat
このプロパティは、バブルチャットが有効かどうかを示します。Players:SetChatStyle() メソッドを使用して、Enum.ChatStyle 枚数を使用して設定されます。
このチャットモードが有効になっていると、ゲームはチャットユーザーインターフェイスを画面の左上隅に表示します。
他にも2つのチャットモードがあります、Players.ClassicChat と、クラシックとバブルチャットの両方が有効になっているチャットモードです。
CharacterAutoLoads
このプロパティは、characters が自動的に再生するかどうかを示します。デフォルト値は true です。
このプロパティが無効になっている場合 (false)、プレイヤー は、プレイヤーがエクスペリエンスに参加するたびに 関数が呼び出されるまで、生成されません。
これは、プレイヤーに終わりのある生命がある経験で役立つ可能性があります、例えば、プレイヤーがゲームラウンドが終了するまでリスポーンしない競争ゲームです。
コードサンプル
local Players = game:GetService("Players")
-- Set CharacterAutoLoads to false
Players.CharacterAutoLoads = false
-- Remove player's character from workspace on death
Players.PlayerAdded:Connect(function(player)
while true do
local char = player.CharacterAdded:Wait()
char.Humanoid.Died:Connect(function()
char:Destroy()
end)
end
end)
-- Respawn all dead players once every 10 seconds
while true do
local players = Players:GetChildren()
-- Check if each player is dead by checking if they have no character, if dead load that player's character
for _, player in pairs(players) do
if not workspace:FindFirstChild(player.Name) then
player:LoadCharacter()
end
end
-- Wait 10 seconds until next respawn check
task.wait(10)
end
ClassicChat
クラシックチャットが有効かどうかを示します。このプロパティは、Players:SetChatStyle() メソッドを使用して Enum.ChatStyle 枚数を設定します。
このチャットモードが有効になっていると、ゲームは送信者の頭上のバブルにチャットを表示します。
他にも2つのチャットモードがあります、Players.BubbleChat と、クラシックとバブルチャットの両方が有効になっているチャットモードです。
LocalPlayer
この読み込み専用プロパティは、クライアントがエクスペリエンスを実行している Player を参照します。
このプロパティは、クライアント上で実行するため、LocalScripts および ModuleScripts が必要なものにのみ定義されています。For the server, on which Script オブジェクトがコードを実行するサーバーの場合、このプロパティは nil です。
MaxPlayers
このプロパティは、サーバーに入れることができる最大プレイヤー数を決定します。このプロパティは、クリエイターダッシュボード または ゲーム設定 で特定の場プレースの設定を通じてのみ設定できます。
PreferredPlayers
このプロパティは、Roblox のマッチメイカーがサーバーを満たすプレイヤーの数を示します。この数は、エクスペリエンスがサポートする最大プレイヤー数(Players.MaxPlayers)より少ないでしょう。
RespawnTime
このプロパティは、Players.CharacterAutoLoads が true になると、プレイヤーがリスポーンする時間、秒で制御します。デフォルトは 5.0秒です。
これは、経験の種類に基づいてリスポーンにかかる時間を変更したいが、個々のプレイヤーのスポーンを処理したくない場合に便利です。
このプロパティは、 内で設定できますが、Studio の Explorer ウィンドウで直接設定できるようになります。
UseStrafingAnimations
方法
Chat
この機能は、ローカルプレイヤーに指定されたメッセージをチャットさせます。このアイテムは保護されているので、Script または LocalScript で使おうとするとエラーが発生します。
代わりに、カスタムチャットシステム、またはチャットへのアクセスが必要なシステムを作成するときは、Chat サービスのChat:Chat()機能を代わりに使用できます。
パラメータ
メッセージチャット。
戻り値
コードサンプル
-- Command bar
game:GetService("Players"):Chat("Hello, world!") --Results in 'Hello, world!' appearing in the Chat log under your Player's name.
-- Script
local Players = game:GetService("Players")
Players:Chat("Hello, world!") --Errors
GetPlayerByUserId
この機能は、Player にあるすべての Players を検索し、Player.UserId が指定された userId に一致するものを検索します。そのようなプレイヤーが存在しない場合、返す nil 。
このメソッドは、購入者を含む開発者製品の購入者を見つけるのに便利で、MarketplaceService.ProcessReceipt を提供し、購入者の UserId と 参照はない Player オブジェクト自体を含むテーブルを含むことができます。ほとんどのエクスペリエンスは、製品を付与するにはプレイヤーへの参照が必要です。
パラメータ
指定されているプレイヤーの Player.UserId 。
戻り値
コードサンプル
local Players = game:GetService("Players")
local player = Players:GetPlayerByUserId(1)
if player then
print("Player with userId 1 is in this server! Their name is: " .. player.Name)
else
print("Player with userId 1 is not in this server!")
end
GetPlayerFromCharacter
この機能は、指定された または に関連する を返します。一致できない場合は、 または を返します。次の機能と同等です:
local function getPlayerFromCharacter(character)
for _, player in game:GetService("Players"):GetPlayers() do
if player.Character == character then
return player
end
end
end
このメソッドは、プレイヤーのキャラクターのいくつかのイベントが発動するときによく使用されます (例: 彼らの Humanoid dying )。そのようなイベントは、プレイヤーオブジェクトを直接参照しないかもしれませんが、このメソッドは簡単にアクセスできます。この機能の逆は、プレイヤーのキャラクターを取得すると説明できます。これを行うには、単にキャラクタープロパティにアクセスします。
パラメータ
プレイヤーを取得したいキャラクターインスタンス。
戻り値
コードサンプル
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local PLAYER_NAME = "Nightriff"
local character = Workspace:FindFirstChild(PLAYER_NAME)
local player = Players:GetPlayerFromCharacter(character)
if player then
print(`Player {player.Name} ({player.UserId}) is in the game`)
else
print(`Player {PLAYER_NAME} is not in the game!`)
end
GetPlayers
このメソッドは、現在接続されているすべての Player オブジェクトのテーブルを返します。それは同じ方法で機能します Instance:GetChildren() を除き、Player オブジェクトを Players の下でのみ返します。for ループと一緒に使用すると、ゲームのすべてのプレイヤーを反復するのに便利です。
local Players = game:GetService("Players")for _, player in Players:GetPlayers() doprint(player.Name)end
Players.PlayerAdded に接続するスクリプトは、よくゲームに接続するすべてのプレイヤーを処理しようとしています。このメソッドは、既に接続されたプレイヤーを反復するのに便利で、PlayerAdded を発射しないものです。この方法を使用すると、プレイヤーを見逃さないようになります!
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("Player: " .. player.Name)
end
for _, player in Players:GetPlayers() do
onPlayerAdded(player)
end
Players.PlayerAdded:Connect(onPlayerAdded)
戻り値
サーバー内のすべてのプレイヤーを含むテーブル。
コードサンプル
local Players = game:GetService("Players")
local function onCharacterAdded(character)
-- Give them sparkles on their head if they don't have them yet
if not character:FindFirstChild("Sparkles") then
local sparkles = Instance.new("Sparkles")
sparkles.Parent = character:WaitForChild("Head")
end
end
local function onPlayerAdded(player)
-- Check if they already spawned in
if player.Character then
onCharacterAdded(player.Character)
end
-- Listen for the player (re)spawning
player.CharacterAdded:Connect(onCharacterAdded)
end
Players.PlayerAdded:Connect(onPlayerAdded)
SetChatStyle
この機能は、BubbleChat と ClassicChat が使用されているかどうかを設定し、チームチャットとチャットに Enum.ChatStyle 枚列を使用して何をすべきかを告知します。このアイテムは保護されているので、Script または LocalScript で使おうとするとエラーが発生します。
この機能は、ゲームによってチャットモードが設定されたとき内部で使用されます。
パラメータ
指定されたチャットスタイルが設設定するされました。
戻り値
コードサンプル
-- Command bar
game.Players:SetChatStyle(Enum.ChatStyle.Classic) -- Set's chat style to Classic
-- LocalScript
local Players = game:GetService("Players")
Players:SetChatStyle(Enum.ChatStyle.Classic) -- Errors
TeamChat
この機能は、Players.LocalPlayer チャットに指定されたメッセージを表示し、同じチームのユーザーにのみ表示されます。このアイテムは保護されているので、Script または LocalScript で使おうとするとエラーが発生します。
この機能は、Players.LocalPlayer がチームにメッセージを送信するときに内部で使用されます。
パラメータ
チャット中のメッセージ。
戻り値
コードサンプル
-- Command bar
game.Players:TeamChat("Hello World") -- Sends a "Hello World" message to all players on the local player's team
-- LocalScript
local Players = game:GetService("Players")
Players:TeamChat("Hello World") -- Errors
BanAsync
Players:BanAsync() メソッドでは、エクスペリエンスのガイドラインに違反するユーザーを簡単に禁止できます。禁止期間を指定し、疑わしい代替アカウントに禁止を拡散させ、使用ガイドライン に従って禁止されたユーザーにメッセージを提異議申し立てできます。また、すべてのユーザーにアクセス可能な場所にあなたの経験ルールを投稿し、彼らが上訴できる方法を提供する必要があります。このメソッドは、Players.BanningEnabled プロパティによって有効化および無効化され、Studio で切り替えることができます。
禁止とメッセージ送信
禁止されたユーザーはすぐに排除され、エクスペリエンスに再参加することを禁止されます。彼らは、禁止時間とあなたの DisplayReason に残された時間を表示するエラーモードが表示されます。Roblox のバックエンドシステムは、指定した場プレースすべてのサーバーからプレイヤーを排除します。DisplayReason 最大長は 400 文字であり、テキストフィルターに対応します。受容可能なモーダルテキストに関する詳細は、禁止メッセージ を参照してください。
場所と宇宙
デフォルトでは、禁止はその宇宙内のどこかに拡張されます。この API が呼ばれている場所にのみ禁止を制限するには、ApplyToUniverse を false に構成します。しかし、ユーザーが宇宙の開始場所で禁止されると、ユニバーサル禁止が存在するかどうかにかかわらず、効果的にユーザーが宇宙全体から排除されることになります。
代替アカウント
ユーザはしばしば複数の異なるアカウント、別のアカウントまたは代替アカウントと呼ばれるものをプレイし、アカウント禁止を回避するために使用されます。禁止ユーザーを外すのを助けるために、この API のデフォルト動作は、禁止したソースアカウントから、疑われる代替アカウントのすべての禁止を拡散します。You can turn off ban propagations to alt accounts by configuring ExcludeAltAccounts to true .
禁止期間
すべての違反が同じではないので、すべての禁止が同じ長さである必要はありません。この API では、Duration フィールドで、禁アカウント停止の期間を秒単位で設定できます。永久禁アカウント停止を指定するには、フィールドを -1 に設定します。また、Players:GetBanHistoryAsync() を使用してクエリできるユーザーの禁止履歴に基づいて、禁止期間を動的に設定したい場合もあります。たとえば、禁止数、以前の禁止の期間、またはビルドロジックを保存したノート PrivateReason の下で保存されたメモの長さ (最大 1000 文字であり、テキストがフィルタリングされていません) を考慮したいかもしれません。PrivateReason ノートは決してクライアントと共有されず、攻撃者から安全と考えられます。
エラーと制限付き
このメソッドは、制限され、失敗する可能性のあるバックエンドサービスへの HTTP 呼び出しを発動します。この API を 1つ以上の UserId で呼んでいる場合、このメソッドは、それぞれのIDに対して HTTP 呼び出しを行おうとします。その後、すべてのエラーメッセージを集計し、コンマで区切られたリストとして結合します。たとえば、このメソッドが 5 ユーザーに呼び出され、 UserIds 2 と 4 を持つユーザーのリクエストが失敗した場合、次のエラーメッセージが表示されます:
HTTP failure for UserId 2: Timedout, HTTP 504 (Service unavailable) failure for UserId 4: Service exception
メッセージは常に failure for UserId {} を含むことになりますが、HTTP エラーの場合です。
クライアント側要件
ユーザーを禁止するリスクにより、このメソッドはバックエンドエクスペリエンスサーバー (クライアント側の呼び出しでエラーが発生する) でのみ呼び出されます。この API を Studi作品 で、共同作業 中、または チームテスト でテストできますが、生産には禁止が適用されません。
この API は ユーザー制限オープンクラウド API を使用します。これらの API を使用して、サードパーティのアプリケーションで禁止を管理できます。
パラメータ
UserIds (必須; 配列) — 禁止されるプレイヤーの UserIds の配列。最大サイズは 50 です。
ApplyToUniverse (オプション; ブール) — 禁止がエクスペリエンス宇宙内のすべての場所に拡散するかどうか。デフォルトは true です。
Duration (必須; 整数) — アカウント停止止の期間、秒。永久禁止は -1 の値を持つべきです。0 および他のすべてのネガティブ値は無効です。
DisplayReason (必須; 文字列) — ユーザーがエクスペリエンスに参加しようとして失敗したときに表示されるメッセージ。最大ストリング長は 400 です。
PrivateReason (必須; 文字列) — ユーザーの禁止履歴をクエリーすると返される内部メッセージ。最大文字列長は 1000 です。
ExcludeAltAccounts (オプション; ブール) — true のとき、Roblox は代替アカウントを禁止しようとしません。デフォルトは false です。
戻り値
コードサンプル
local Players = game:GetService("Players")
if shouldBeBanned(player) then
local banHistoryPages = Players:GetBanHistoryAsync(player.UserId)
local duration = getNextBanDuration(banHistoryPages) -- Creator-implemented logic
local config: BanConfigType = {
UserIds = { player.UserId },
Duration = duration,
DisplayReason = "You violated community guideline #5",
PrivateReason = "Put anything here that the user should not know but is helpful for your records",
ExcludeAltAccounts = false,
ApplyToUniverse = true,
}
local success, err = pcall(function()
return Players:BanAsync(config)
end)
print(success, err)
end
CreateHumanoidModelFromDescription
パスされた HumanoidDescription に指定されたすべてを装備したキャラクターモデルを返し、rigType によって指定された R6 または R15 です。
パラメータ
返されたキャラクターの外観を指定します。
返されたキャラクターが R6 か R15 かを指定します。
アセットタイプの検証では、この機能がモデルをロードするかどうかを判断します (カタログ資産以外の資産をロードしたい場合は、常にに設定する必要があります)。
戻り値
ヒューマノイドキャラクタモデル。
コードサンプル
game.Players:CreateHumanoidModelFromDescription(Instance.new("HumanoidDescription"), Enum.HumanoidRigType.R15).Parent =
game.Workspace
CreateHumanoidModelFromUserId
パスされたユーザーのアバターに一致するように装備されたキャラクターモデル設定を返します。Returns a character Model set-up with everything equipped to match the avatar of the user specified by the passed in userId.これには、そのキャラクターが現在 R6 か R15 かどうかが含まれます。
パラメータ
Roblox ユーザーのユーザーID。(ユーザーID はユーザープロフィールの番号ですなど www.roblox.com/users/1/profile)
戻り値
ヒューマノイドキャラクタモデル。
コードサンプル
game.Players:CreateHumanoidModelFromUserId(1).Parent = game.Workspace
GetBanHistoryAsync
エクスペリエンスの宇宙内のユーザーの禁止と解除履歴を取得します。このメソッドは、BanHistoryPages から継承される Pages インスタンスを返します。このメソッドは、Players.BanningEnabled プロパティによって有効化および無効化され、Studio で切り替えることができます。
この関数呼び出しは、プロダクションゲームサーバーでのみ成功し、クライアントデバイスまたは Studio では成功しません。
この API は ユーザー制限オープンクラウド API を使用します。これらの API を使用して、サードパーティのアプリケーションで禁止を管理できます。
パラメータ
戻り値
返回参照は BanHistoryPages を参照してください。
GetCharacterAppearanceInfoAsync
この機能は、Roblox ウェブサイトでプレイヤーのアバター (装ギアを無視) に関する情報を辞書の形式で返します。これは、このメソッドで説明されたアセットを実際にロードする GetCharacterAppearanceAsync と混同してはならない。InsertService:LoadAsset() を使用して、プレイヤーのアバターで使用されるアセットをロードできます。返された辞書の構造は次のとおりです:
<th>種類</th><th>説明</th></tr></thead><tr><td><code>アセット</code></td><td>テーブル (下を参照)</td><td>装備されたアセット (帽子、体部など) を説明する</td></tr><tr><td><code>ボディカラー</code></td><td>テーブル (下を参照)</td><td>各肢の BrickColor 値を説明する</td></tr><tr><td><code>bodyColor3s</code></td><td>テーブル (下を参照)</td><td>体色と完全に一致しない可能性のある各肢の Color3 インスタンスを説明します</td></tr><tr><td><code>デフォルトのパンツが適用されました</code></td><td>bool</td><td>デフォルトのパンツが適用されるかどうかを説明します</td></tr><tr><td><code>デフォルトシャツ適用</code></td><td>bool</td><td>デフォルトのシャツが適用されるかどうかを説明します</td></tr><tr><td><code>エモート</code></td><td>テーブル (下を参照)</td><td>装備されたエモートアニメーションを説明する</td></tr><tr><td><code>プレイヤーアバタータイプ</code></td><td>文字列</td><td>「R15」または「R6」</td></tr><tr><td><code>スケール</code></td><td>テーブル (下を参照)</td><td>さまざまなボディスケーリング因子を説明する</td></tr>
名前 |
---|
アセットサブテーブル
assets テーブルは、プレイヤーが現在装備しているアセットを説明する次のキーを含むテーブルの配列です:
<th>種類</th><th>説明</th></tr></thead><tr><td><code>id</code></td><td>番号</td><td>装備されたアセットのアセットID</td></tr><tr><td><code>アセットタイプ</code></td><td>テーブル</td><td>名前 と id フィールドを持つテーブル、それぞれが装備されたアセットの種類を説明 ("帽子"、"顔"など)</td></tr><tr><td><code>名前</code></td><td>文字列</td><td>装備されたアセットの名前</td></tr>
名前 |
---|
スケールサブテーブル
scales テーブルには、それぞれ 1 つの Humanoid スケーリングプロパティに対応する次のキーがあります:bodyType、head、height、proportion、depth、width。
ボディカラーサブテーブル
The bodyColors table has the following keys, each a number corresponding to a BrickColor ID number that can be used with BrickColor.new(id) : leftArmColorId , torsoColorId , rightArmColorId , headColorId , leftLegColorId , rightLegColorId .
パラメータ
指定されたプレイヤーの * id。
戻り値
特定のユーザーのキャラクターの外観に関する情報を含む辞書。
コードサンプル
local result = {
playerAvatarType = "R15",
defaultPantsApplied = false,
defaultShirtApplied = false,
scales = {
bodyType = 0,
head = 1,
height = 1.05,
proportion = 0,
depth = 0.92,
width = 0.85,
},
bodyColors = {
leftArmColorId = 1030,
torsoColorId = 1001,
rightArmColorId = 1030,
headColorId = 1030,
leftLegColorId = 1001,
rightLegColorId = 1001,
},
assets = {
{
id = 1031492,
assetType = {
name = "Hat",
id = 8,
},
name = "Striped Hat",
},
{
id = 13062491,
assetType = {
name = "Face Accessory",
id = 42,
},
name = "Vision Française ",
},
{
id = 16598440,
assetType = {
name = "Neck Accessory",
id = 43,
},
name = "Red Bow Tie",
},
{
id = 28999228,
assetType = {
name = "Face",
id = 18,
},
name = "Joyous Surprise",
},
{
id = 86896488,
assetType = {
name = "Shirt",
id = 11,
},
name = "Expensive Red Tuxedo Jacket",
},
{
id = 86896502,
assetType = {
name = "Pants",
id = 12,
},
name = "Expensive Red Tuxedo Pants",
},
{
id = 376530220,
assetType = {
name = "Left Arm",
id = 29,
},
name = "ROBLOX Boy Left Arm",
},
{
id = 376531012,
assetType = {
name = "Right Arm",
id = 28,
},
name = "ROBLOX Boy Right Arm",
},
{
id = 376531300,
assetType = {
name = "Left Leg",
id = 30,
},
name = "ROBLOX Boy Left Leg",
},
{
id = 376531703,
assetType = {
name = "Right Leg",
id = 31,
},
name = "ROBLOX Boy Right Leg",
},
{
id = 376532000,
assetType = {
name = "Torso",
id = 27,
},
name = "ROBLOX Boy Torso",
},
},
}
print(result)
GetFriendsAsync
GetFriends Players 関数は、指定されたユーザーの友達の情報を含む FriendPages オブジェクトを返します。FriendPages オブジェクト内のアイテムは、次のフィールドを持つテーブルです:
<th>種類</th><th>説明</th></tr></thead><tr><td>Id</td><td>int64</td><td>友達のユーザーID</td></tr><tr><td>ユーザー名</td><td>文字列</td><td>友達のユーザー名</td></tr><tr><td>表示名称</td><td>文字列</td><td>友達の <code>Class.Player.DisplayName|display name</code> 。</td></tr>
名前 |
---|
コードサンプルを見て、すべてのプレイヤーの友達を反復する簡単な方法を見つけましょう。
パラメータ
指定されたプレイヤーのユーザーID。
戻り値
コードサンプル
local Players = game:GetService("Players")
local USERNAME = "Cozecant"
local function iterPageItems(pages)
return coroutine.wrap(function()
local pagenum = 1
while true do
for _, item in ipairs(pages:GetCurrentPage()) do
coroutine.yield(item, pagenum)
end
if pages.IsFinished then
break
end
pages:AdvanceToNextPageAsync()
pagenum = pagenum + 1
end
end)
end
-- First, get the user ID of the player
local userId = Players:GetUserIdFromNameAsync(USERNAME)
-- Then, get a FriendPages object for their friends
local friendPages = Players:GetFriendsAsync(userId)
-- Iterate over the items in the pages. For FriendPages, these
-- are tables of information about the friend, including Username.
-- Collect each username in a table
local usernames = {}
for item, _pageNo in iterPageItems(friendPages) do
table.insert(usernames, item.Username)
end
print("Friends of " .. USERNAME .. ": " .. table.concat(usernames, ", "))
GetHumanoidDescriptionFromOutfitId
指定された衣装IDに対してヒューマノイドの説明を返し、衣装のパーツ/カラー/アニメーションなどで設定されます。衣装はユーザーによって作成されたもの、または Roblox によって作成されたバンドルの衣装であることができます。
パラメータ
HumanoidDescription が検索される衣装の ID。
戻り値
パスされた outfitId の仕様で初期化されたヒューマノイドの説明。
コードサンプル
local Players = game:GetService("Players")
local Workspace = game:GetService("Workspace")
local function getOutfitId(bundleId)
if bundleId <= 0 then
return
end
local info = game.AssetService:GetBundleDetailsAsync(bundleId)
if not info then
return
end
for _, item in pairs(info.Items) do
if item.Type == "UserOutfit" then
return item.Id
end
end
return nil
end
local function getHumanoidDescriptionBundle(bundleId)
local itemId = getOutfitId(bundleId)
if itemId and itemId > 0 then
return Players:GetHumanoidDescriptionFromOutfitId(itemId)
end
return nil
end
local humanoidDescription = getHumanoidDescriptionBundle(799)
local humanoidModel = Players:CreateHumanoidModelFromDescription(humanoidDescription, Enum.HumanoidRigType.R15)
humanoidModel.Parent = Workspace
GetHumanoidDescriptionFromUserId
パスされたユーザーのアバターに指定されたものすべてを装備する HumanoidDescription を返します。スケールとボディカラーも含まれます。
パラメータ
Roblox ユーザーのユーザーID。(ユーザーID はユーザープロフィールの番号ですなど www.roblox.com/users/1/profile)
戻り値
ユーザーのアバター仕様で初期化されたヒューマノイドの説明。
コードサンプル
game.Players:CreateHumanoidModelFromDescription(
game.Players:GetHumanoidDescriptionFromUserId(1),
Enum.HumanoidRigType.R15
).Parent =
game.Workspace
GetNameFromUserIdAsync
GetNameFromUserIdAsync Players 関数は、指定された UserId のアカウントのユーザー名が何であるかを尋ねる Roblox ウェブサイトへのクエリを送信します。
このメソッドは、指定されたユーザーIDでアカウントが存在しない場合にエラーが発生します。そのようなアカウントが存在するかどうか確信できない場合は、この関数に対する呼び出しを pcall() で包むことをお勧めします。さらに、結果を手動でキャッシュして、同じユーザーID で将来の呼び出しを高速に行うこともできます。コードサンプルを見て、詳しく学ぶ。
パラメータ
指定されているプレイヤーの Player.UserId 。
戻り値
指定された Player.UserId を持つユーザーの名前。
コードサンプル
local Players = game:GetService("Players")
-- Example Data:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
local nameOne = Players:GetNameFromUserIdAsync(118271)
local nameTwo = Players:GetNameFromUserIdAsync(131963979)
print(nameOne, nameTwo)
-- prints: "RobloxRulez docsRule"
local Players = game:GetService("Players")
-- Create a table called 'cache' to store each 'Name' as they are found.
-- If we lookup a 'Name' using the same 'UserId', the 'Name' will come
-- from cache (fast) instead of GetNameFromUserIdAsync() (yields).
local cache = {}
function getNameFromUserId(userId)
-- First, check if the cache contains 'userId'
local nameFromCache = cache[userId]
if nameFromCache then
-- if a value was stored in the cache at key 'userId', then this 'nameFromCache'
-- is the correct Name and we can return it.
return nameFromCache
end
-- If here, 'userId' was not previously looked up and does not exist in the
-- cache. Now we need to use GetNameFromUserIdAsync() to look up the name
local name
local success, _ = pcall(function()
name = Players:GetNameFromUserIdAsync(userId)
end)
if success then
-- if 'success' is true, GetNameFromUserIdAsync() successfully found the
-- name. Store this name in the cache using 'userId' as the key so we
-- never have to look this name up in the future. Then return name.
cache[userId] = name
return name
end
-- If here, 'success' was false, meaning GetNameFromUserIdAsync()
-- was unable to find the 'name' for the 'userId' provided. Warn the user
-- this happened and then return nothing, or nil.
warn("Unable to find Name for UserId:", userId)
return nil
end
-- Example Data:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
-- The first time a UserId is used, GetNameFromUserIdAsync() will be called
local nameOne = getNameFromUserId(118271)
local nameTwo = getNameFromUserId(131963979)
-- Because 118271 was previously used, get its Name from the cache
local nameOneQuick = getNameFromUserId(118271)
print(nameOne, nameTwo, nameOneQuick)
-- prints: "RobloxRulez docsRule RobloxRulez"
GetUserIdFromNameAsync
この機能は、Roblox ウェブサイトにクエリを送信し、指定された Player.UserId 名のアカウントの Player が何であるかを尋ねます。
このメソッドは、指定されたユーザー名でアカウントが存在しない場合にエラーが発生します。そのようなアカウントが存在するかどうか確信できない場合は、この関数に対する呼び出しを pcall() で包むことをお勧めします。さらに、結果を手動でキャッシュして、同じユーザー名を使用して将来の呼び出しを迅速に行うこともできます。コードサンプルを見て、詳しく学ぶ。
パラメータ
指定されたプレイヤーのユーザー名。
戻り値
名前が指定されたユーザーの Player.UserId
コードサンプル
local Players = game:GetService("Players")
-- Example Data:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
local userIdOne = Players:GetUserIdFromNameAsync("RobloxRulez")
local userIdTwo = Players:GetUserIdFromNameAsync("docsRule")
print(userIdOne, userIdTwo)
-- prints: "118271 131963979"
local Players = game:GetService("Players")
-- Create a table called 'cache' to store each 'UserId' as they are found.
-- If we lookup a 'UserId' using the same 'Name', the 'UserId' will come
-- from cache (fast) instead of GetUserIdFromNameAsync() (yields).
local cache = {}
function getUserIdFromName(name)
-- First, check if the cache contains 'name'
local userIdFromCache = cache[name]
if userIdFromCache then
-- if a value was stored in the cache at key 'name', then this 'userIdFromCache'
-- is the correct UserId and we can return it.
return userIdFromCache
end
-- If here, 'name' was not previously looked up and does not exist in the
-- cache. Now we need to use GetUserIdFromNameAsync() to look up the userId
local userId
local success, _ = pcall(function()
userId = Players:GetUserIdFromNameAsync(name)
end)
if success then
-- if 'success' is true, GetUserIdFromNameAsync() successfully found the
-- userId. Store this userId in the cache using 'name' as the key so we
-- never have to look this userId up in the future. Then return userId.
cache[name] = userId
return userId
end
-- If here, 'success' was false, meaning GetUserIdFromNameAsync()
-- was unable to find the 'userId' for the 'name' provided. We can warn the
-- user this happened and then return nothing, or nil.
warn("Unable to find UserId for Name:", name)
return nil
end
-- Example Data:
-- UserId: 118271 Name: "RobloxRulez"
-- UserId: 131963979 Name: "docsRule"
-- The first time a Name is used, GetUserIdFromNameAsync() will be called
local userIdOne = getUserIdFromName("RobloxRulez")
local userIdTwo = getUserIdFromName("docsRule")
-- Because "RobloxRulez" was previously used, get its UserId from the cache
local userIdOneQuick = getUserIdFromName("RobloxRulez")
print(userIdOne, userIdTwo, userIdOneQuick)
-- prints: "118271 131963979 118271"
GetUserThumbnailAsync
この機能は、プレイヤーのアバターの画像のコンテンツ URLを返し、UserId 、希望の画像サイズを Enum.ThumbnailSize 枚数、および希望のタイプを Enum.ThumbnailType 枚数とします。また、画像が使用できるかどうかを説明するブールを返します。
ほとんどの場合、このメソッドは ImageLabel.Image または Decal.Texture を使用して、エクスペリエンスでユーザーアバター画像を表示するために使用されます。
パラメータ
指定されているプレイヤーの Player.UserId 。
A Enum.ThumbnailType サムネイルの種類を説明する。
A Enum.ThumbnailSize サムネイルのサイズを指定する。
戻り値
指定されたパラメータに基づいてユーザーサムネイルのコンテンツ URL と、画像が使用できるかどうかを説明する bool を含むトゥプル。
コードサンプル
local Players = game:GetService("Players")
local player = Players.LocalPlayer
local PLACEHOLDER_IMAGE = "rbxassetid://0" -- replace with placeholder image
-- fetch the thumbnail
local userId = player.UserId
local thumbType = Enum.ThumbnailType.HeadShot
local thumbSize = Enum.ThumbnailSize.Size420x420
local content, isReady = Players:GetUserThumbnailAsync(userId, thumbType, thumbSize)
-- set the ImageLabel's content to the user thumbnail
local imageLabel = script.Parent
imageLabel.Image = (isReady and content) or PLACEHOLDER_IMAGE
imageLabel.Size = UDim2.new(0, 420, 0, 420)
UnbanAsync
プレイヤーを Players:BanAsync() または ユーザー制限オープンクラウド API から禁止解除します。このメソッドは、Players.BanningEnabled プロパティによって有効化および無効化され、Studio で切り替えることができます。
Like Players:BanAsync() のように、このメソッドは、ユーザーを一括解除できる config 辞書を受け取ります。これにより、禁止解除されたユーザーと禁止解除された範囲が設定されます。
禁止の解除は、同じ ApplyToUniverse スコープの禁止にのみ効果があります。たとえば、 に設定された禁止を解除すると、 に設定された以前の禁止が無効にならないようになります。言い換えれば、宇宙レベルの禁止は場所レベルの禁アカウント停止を無効にはしません。反対も同じく真実です。
このメソッドは、制限されて失敗する可能性のある HTTP 呼び出しをバックエンドサービスに発行します。複数のユーザーID でこの API を呼び出している場合、このメソッドは、それぞれのユーザーID に対してこの HTTP 呼び出しを行おうとします。その後、すべてのエラーメッセージを集計し、コンマで区切られたリストとして結合します。たとえば、このメソッドが 5 個の UserIds で呼び出され、ユーザー 2 と 4 のリクエストが失敗した場合、次のエラーメッセージが表示されます: {1, 2, 3, 4, 5} メッセージには常に HTTP failure for UserId 2: Timedout, HTTP 504 (Service unavailable) failure for UserId 4: Service exception. が含まれます。HTTP エラーの場合は、failure for UserId {} も含まれます。有効なユーザーIDと無効なユーザーIDの両方を渡した場合は、定義されていない動作です、すなわちネットワークリクエストのすべての入力が有効に検証される前に、一部のリクエストが成功する可能性があるため、正の数字ではない UserId
ユーザーを禁止するリスクにより、このメソッドはバックエンドゲームサーバーでのみ呼び出される可能性があります。クライアント側の呼び出しはエラーになります。Studio、チーム作成、チームテストでこの API をテストできますが、禁止は生産には適用されません。この関数呼び出しは、プロダクションゲームサーバーでの禁止リクエストのみを試み、スタジオテストではありません。しかし、すべての入力検証ステップは、Studio でも引き続き機能します。
この API は ユーザー制限オープンクラウド API を使用します。これらの API を使用して、サードパーティのアプリケーションで禁止を管理できます。
パラメータ
<th>種類</th><th>説明</th></tr></thead><tbody><tr><td><code>ユーザーID</code></td><td>配列</td><td>ユーザーID がエクスペリエンスに強制的に含まれるようにする。最大サイズは <code>50</code> です。</td></tr><tr><td><code>アプリケーションToUniverse</code></td><td>ブールン値</td><td>この宇宙内のすべての場所に禁止解除を拡散します。</td></tr></tbody>
名前 |
---|
戻り値
コードサンプル
local Players = game:GetService("Players")
if shouldBeUnbanned(player) then
local config: UnbanConfigType = {
UserIds = { player.UserId, 789 },
ApplyToUniverse = false,
}
local success, err = pcall(function()
return Players:UnbanAsync(config)
end)
print(success, err)
end
イベント
PlayerAdded
このイベントは、プレイヤーがゲームに入ると発動します。これは、プレイヤーがゲームに参加するときにイベントを発動するのに使用され、例えばプレイヤーの保存済みデータをロードすることです。
これは、プレイヤーがゲームを終了するときに発動する Players.PlayerRemoving イベントと一緒に使用できます。たとえば、新しいプレイヤーがゲームに参加または退出するたびにメッセージを印刷したい場インスタンス:
local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
print(player.Name .. " joined the game!")
end)
Players.PlayerRemoving:Connect(function(player)
print(player.Name .. " left the game!")
end)
プレイヤーのキャラクターがゲームに追加または削除されたときを追跡したい、例えば、プレイヤーがリスポーンしたり死んだりするとき、Player.CharacterAdded および Player.CharacterRemoving 機能を使用できます。
このイベントは、 プレイ モードでは、プレイヤーが PlayerAdded に接続するスクリプトを実行する前に作成されるため、期待通りに機能しません。このケースと、プレイヤーがゲームに入った後にスクリプトが追加されるケースを処理するには、プレイヤーの入り口を処理するために呼び出すことができる onPlayerAdded() 関数を作成してください。
パラメータ
ゲームに参加したプレイヤーのインスタンス。
コードサンプル
local Players = game:GetService("Players")
local function onPlayerAdded(player)
print("A player has entered: " .. player.Name)
end
Players.PlayerAdded:Connect(onPlayerAdded)
PlayerMembershipChanged
このイベントは、ゲームサーバーがプレイヤーのメンバーシップが変更されたことを認識したときに発動します。ただし、サーバーはプレミアムモードが閉じられた後にのみメンバーシップをチェックし更新しようとします 後 。たとえば、ゲームをプレイ中にユーザーがプレミアムを購入するケースを考えると、プレミアムを購入するように依然として促す必要があります。こうすることで、ゲームサーバーがメンバーシップをアップグレードし、このイベントをトリガーするという状況を回避できます。
プレミアムについて詳しく学び、エンゲージメントベースの支払いシステムで体験を構築し、エンゲージメントベースの支払いシステムで収益化するには、エンゲージメントベースの支払い を参照してください。
参照してください:
- MarketplaceService:PromptPremiumPurchase() , ユーザーにプレミアム購入を促すために使用
- MarketplaceService.PromptPremiumPurchaseFinished , プレミアム購入 UI が閉じると発火する
パラメータ
コードサンプル
local Players = game:GetService("Players")
local function grantPremiumBenefits(player)
-- Grant the player access to Premium-only areas, items, or anything you can imagine!
print("Giving", player, "premium benefits!")
end
local function playerAdded(player)
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
local function playerMembershipChanged(player)
print("Received event PlayerMembershipChanged. New membership = " .. tostring(player.MembershipType))
if player.MembershipType == Enum.MembershipType.Premium then
grantPremiumBenefits(player)
end
end
Players.PlayerAdded:Connect(playerAdded)
Players.PlayerMembershipChanged:Connect(playerMembershipChanged)
PlayerRemoving
プレイヤー削除イベントは、Player がゲームを終了する直前に発動します。このイベントは、ChildRemoved が Players で行う前に発動し、Instance.DescendantRemoving とほぼ同じように動作します。実際の Player の削除前に発射するため、このイベントは GlobalDataStore を使用してプレイヤーデータを保存するのに便利です。
これは、プレイヤーがゲームに参加すると発動する Player.PlayerAdded イベントと一緒に使用できます。たとえば、新しいプレイヤーがゲームに参加または退出するたびにメッセージを印刷するには:
local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
print(player.Name .. " joined the game!")
end)
Players.PlayerRemoving:Connect(function(player)
print(player.Name .. " left the game!")
end)
プレイヤーのキャラクターがゲームに追加または削除されたときを追跡したい、例えば、プレイヤーがリスポーンしたり死んだりするとき、Player.CharacterAdded および Player.CharacterRemoving 機能を使用できます。
パラメータ
ゲームを終了するプレイヤーのインスタンス。
コードサンプル
local Players = game:GetService("Players")
local function onPlayerRemoving(player)
print("A player has left: " .. player.Name)
end
Players.PlayerRemoving:Connect(onPlayerRemoving)
UserSubscriptionStatusChanged
このイベントは、ゲームサーバーが特定のサブスクリプションのユーザーのステータスが変更されたことを認識したときに発動します。サーバーは、サブスクリプション購入モードが閉じられた後にのみ、ステータスをチェックして更新しようとします 後 。ゲームをプレイ中にユーザーがサブスクリプションを購入するケースを考慮するには、サブスクリプションを購入するように依然として促す必要があります;促しはユーザーにすでにサブスクリプションに登録されているというメッセージを表示し、モーダルを閉じた後、ゲームサーバーはサブスクリプションのステータスを更新し、このイベントをトリガーします。
サーバースクリプトのみがこのイベントを受信することに注意してください。