フレンドロケータ

エクスペリエンス中に友達を見つけるのは困難です。FriendsLocator開発者モジュール は、プレイヤーが場プレース内の友達に簡単に見つけてテレポートできます。

モジュール使用

インストール

エクスペリエンスで FriendsLocator モジュールを使用するには：

1. 从 the ビュー タブで、ツールボックスを開き、 クリエイターストア タブを選択します。

   

2. モデル ソートが選択されていることを確認してから、 すべてを表示 ボタンをクリックして、 カテゴリ のための 1>ボタン1> をクリックします。

   

3. デバッグモジュール タイルを見つけてクリックします。

   

4. 友達ロケーターモジュールを 見つけ 、クリックするか、3D ビューにドラッグアンドドロップします。

   

5. In the エクスプローラー ウィンドウ, move the entire FriendsLocator model into ServerScriptService . エクスペリエンスを実行すると、モジュールはさまざまなサービスに分配され、実行を開始します。

   

スタジオでテスト

Studio のモジュールをテストするには、 FriendsLocator モジュールはソロプレイテスト中に複数のクライアントで実行する必要があります。

1. In StarterPlayerScripts で、新しい LocalScript を作成し、 友達ロケーターを構成 を名前変更します。

   

2. 新しい ConfigureFriendsLocator スクリプトに以下のコードを貼り付けます。showAllPlayers 設定は、configure 機能内の 1> locators1> がすべてのユーザーをテスト中に Studio で表示されることを確認しますが、公開された場プレースではありません。

   ローカルスクリプト - 友達ロケータを構成する
   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(),  -- Studio でデバッグを有効にする
   })

3. [テスト] タブから、クライアントとサーバーの次のコンビネーションを選択し、開始 ボタンをクリックします。スタジオの 3つの新しいインスタンスがオープンします。1つのシミュレートサーバーと 2つのシミュレートクライアント。

   

4. クライアント Studio インスタンスの 1つに移動し、他のキャラクターから 100 スタッドの距離を移動すると、 場所を特定するアイコン が頭上に表示されるでしょう。

   

   Studio でユーザーID が処理される方法により、アバター画像はテスト中にロケーターアイコンに表示されません。

   デフォルトでは、友達のアイコンをクリック/タップすると、そのキャラクターの場所にテレポートされます。このデフォルトの動作を維持すると、ストリーミングの一時停止が インスタンスストリーミング アーキテクチャの下で発生する可能性があります。テレポート場所の周りに リク

イベントに接続する

FriendsLocator モジュールは、ユーザーがロケーターアイコンと対話するときにカスタム動作を紹介するために イベント を露出します。

1. Make sure that you've created the ConfigureFriendsLocator script outlined in Studioでテスト .

2. スクリプトに8行と11-13行を追加します：

   ローカルスクリプト - 友達ロケータを構成する
   local RunService = game:GetService("RunService")
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))
   
   FriendsLocator.configure({
   	showAllPlayers = RunService:IsStudio(),  -- Studio でデバッグを有効にする
   	teleportToFriend = false,  -- アイコンクリック/タップでテレポートを防止
   })
   
   FriendsLocator.clicked:Connect(function(player, playerCFrame)
   	print("You clicked on locator icon for", player.DisplayName)
   end)

3. マルチクライアントテスト を実行し、別のキャラクターのロケーターアイコンをクリックします。注意に、キャラクターはその場所にテレポートしませんが、イベントがトリガーされて、アイコンクリックをカスタムハンドリングできるようになります。

カスタムロケータ UI

デフォルトスタイルがエクスペリエンスに合わない場合は、デフォルトのアバターポートレート UI を自分の UI に置き換えることができます。

デフォルトの UI を置き換えるには：

1. 新しい ScreenGui インスタンスを StarterGui コンテナ内に作成します。

   

2. 新しい Frame の子として、FriendLocator という名前の ScreenGui インスタンスを作成し、エレメントを追加するようにします。2> Class.ImageLabel|ImageLabels2> や 5> Class.TextLabel|TextLabels5> などのカスタム UI をデザインするために要素を追加

   

3. 終了したら、無効にする親 ScreenGui を、必要になるまでモジュールに表示しないようにします。

   

4. (オプション) 友達のアバターポートレートと DisplayName をカスタム UI のどこかに表示したい場合は、 FriendLocator フレーム内に次のインスタンスを置くことができます。

   • 名前 ImageLabel の Class.ImageLabel。
   • Class.TextLabel の名前の DisplayName 。

   

   モジュールは、これらのアイテムを検索し、それぞれの友達のアバターポートレートと/またはディスプレイ名を表示します。

API リファレンス

機能

環境設定

figfig テーブルの次のキー/値を通じて、デフォルトの設定オプションをオーバーライドします。

ローカルスクリプト - 友達ロケータを構成する
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

FriendsLocator.configure({
	alwaysOnTop = true,
	showAllPlayers = false,
	teleportToFriend = true,
	thresholdDistance = 100,
	maxLocators = 10
})

イベント

クリックしました

ロケーターアイコンがローカルプレイヤーによってクリック/アクティブになると、このイベントは LocalScript 内のみに接続できます。

ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local Players = game:GetService("Players")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

local localPlayer = Players.LocalPlayer

FriendsLocator.clicked:Connect(function(player, playerCFrame)
	-- ターゲットの場所でストリーミングをリクエストする
	if workspace.StreamingEnabled then
		local success, errorMessage = pcall(function()
			localPlayer:RequestStreamAroundAsync(playerCFrame.Position)
		end)
		if not success then
			print(errorMessage)
		end
	end

	print("You clicked on locator icon for", player.DisplayName, "at position", playerCFrame.Position)
end)

透明度変更

ロケーターアイコンがローカルプレイヤーの画面に表示されるとき/隠れるときに発生します。このイベントは、LocalScript にのみ接続できます。

ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local FriendsLocator = require(ReplicatedStorage:WaitForChild("FriendsLocator"))

FriendsLocator.visibilityChanged:Connect(function(player, playerCFrame, isVisible)
	print("Visibility of locator icon for", player.DisplayName, ":", isVisible)
end)