写真ブース

写真を撮ることは、素晴らしい経験を記念する完璧な方法です。 写真ブース の 開発者モジュール は、プレイヤーが自分の経験を反映する背景でユニークなポーズをとることができる簡単に使用できる写真ステージングツールです。

モジュールの使用

インストール

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

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

   

2. モデル の順序が選択されていることを確認し、 すべて表示 ボタンをクリックして、 カテゴリ を選択します。

   

3. ロケートしてクリックして 開発モジュール タイル。

   

4. 写真ブース モジュールを見つけてクリックするか、3D ビューにドラッグアンドドロップします。

   

5. エクスプローラー ウィンドウで、 フォトブース モデル全体を ServerScriptService に移動します。エクスペリエンスを実行すると、モジュールは複数のサービスに分配され、実行を開始します。

   

ブースの位置を設定

モジュールには、3D 世界に配置できる 1つの フォトブース モデルが付属しています。このモデルは、プレイヤーが写真を設定するために相互作用するものです。

1. モジュールのメインフォルダの ワークスペース フォルダ内で フォトブース メッシュを見つけます。

   

2. トップレベルの ワークスペース 階層に移動し、必要な場所に配置します。

   

構成

モジュールはほとんどの使用ケースで動作するようプリコンフィグされていますが、configure 関数を通じて簡単にカスタマイズできます。たとえば、写真の下部のデフォルトメッセージを変更するには：

1. In スタータープレイヤースクリプト , 新しい LocalScript を作成し、名前を カメラブースの設定 に変更します。

   

2. 新しいスクリプトに次のコードを貼り付けます。

   ローカルスクリプト - ConfigurePhotoBooth
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local PhotoBooth = require(ReplicatedStorage:WaitForChild("PhotoBooth"))
   
   PhotoBooth.configure({
   	frameMessage = "First Photo Booth Capture!",
   })

   

イベントに接続する

写真ブースがローカルクライアントに新しい画面を表示するたびに、対応するイベントが発動します。これらのイベントは、LocalScript で接続でき、自分のカスタムロジックで応答できます。

本地スクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

PhotoBooth.countdownStarted:Connect(function()
	print("The countdown has started")
end)

PhotoBooth.printoutShown:Connect(function()
	print("The printout is showing")
end)

PhotoBooth.promptShown:Connect(function()
	print("The camera prompt is showing")
end)

GUI ビジビリティ

デフォルトでは、写真ブースは写真がステージに出されるとすべての ScreenGuis と CoreGuis を隠します。この自動隠し行動をオーバーライドし、プログラマティックにどの GUI が表示されるべきかを決定したい場合は、hideOtherGuis および showOtherGuis コールバックを含め、自分のカスタムロジックで応答します。

本地スクリプト
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local StarterGui = game:GetService("StarterGui")

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

local player = Players.LocalPlayer
local playerGui = player:WaitForChild("PlayerGui")
local hiddenInstances = {}

-- 非表示にならない画面GUIを作成
local specialGuiInstance = Instance.new("ScreenGui")
-- 写真ブースGUIの上に画面GUIを描画
specialGuiInstance.DisplayOrder = 1
specialGuiInstance.Parent = playerGui
-- 画面GUIにアトリビュートを設定して隠れを防ぐ
specialGuiInstance:SetAttribute("ShowInPhotoBooth", true)
-- GUIにテキストラベルを追加する
local specialLabel = Instance.new("TextLabel")
specialLabel.Size = UDim2.fromScale(1, 0.1)
specialLabel.Text = "Remains visible when taking a photo"
specialLabel.Font = Enum.Font.GothamMedium
specialLabel.TextSize = 24
specialLabel.Parent = specialGuiInstance

PhotoBooth.hideOtherGuis(function()
	-- 属性でマークされたものを除き、開発者が定義したすべての画面GUIを非表示にする
	local instances = playerGui:GetChildren()
	for _, instance in instances do
		if instance:IsA("ScreenGui") and not instance:GetAttribute("ShowInPhotoBooth") and instance.Enabled then
			instance.Enabled = false
			table.insert(hiddenInstances, instance)
		end
	end
	-- 特定のコアGUIを非表示にする
	StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, false)
end)

PhotoBooth.showOtherGuis(function()
	-- 非表示になったすべての開発者定義の画面GUIを表示
	for _, instance in hiddenInstances do
		instance.Enabled = true
	end
	hiddenInstances = {}
	-- 非表示になった特定のコアGUIを表示
	StarterGui:SetCoreGuiEnabled(Enum.CoreGuiType.PlayerList, true)
end)

API リファレンス

機能

設定する

次のキー/値を介してデフォルト設定オプションを上書きして、config テーブルの中の。この機能は LocalScript からのみ呼び出すことができます。

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

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

PhotoBooth.configure({
	frameMessage = "What a cool pose!",
	fadeUiDelay = 5,
	maxActivationDistance = 5,
	printoutCharacterSize = UDim2.fromScale(1.5, 1.5),
})

背景を設定する

写真ブースが提供するデフォルトの背景をオーバーライドします。背景画像は最適なエクスペリエンスを提供するために 16:9 のアスペクト比 (1024×768) である必要があり、アセットIDはバックグラウンド配列に含まれる必要があります。1-4（含む）の背景が提供できます。

本地スクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

PhotoBooth.setBackgrounds({
    "rbxassetid://7018713114",
    "rbxassetid://950538356",
})

イベント

カウントダウン開始

カウントダウンが始まると発火します。このイベントは、LocalScript でのみ接続できます。

本地スクリプト' hightlight='5-7
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

PhotoBooth.countdownStarted:Connect(function()
	print("The countdown has started")
end)

印刷したShown

ユーザーに印刷が表示されるときに発火します。このイベントは LocalScript でのみ接続できます。

本地スクリプト' hightlight='5-7
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

PhotoBooth.printoutShown:Connect(function()
	print("The printout is showing")
end)

promptショーン

印刷が閉じられ、カメラボタンが再び表示されるときに発火します。このイベントは LocalScript でのみ接続できます。

本地スクリプト' hightlight='5-7
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

PhotoBooth.promptShown:Connect(function()
	print("The camera prompt is showing")
end)

コールバック

他のGUIを隠す

このコールバックは、印刷が表示される前に即座に実行され、印刷が表示される前に、ScreenGuis またはその内の要素全体を無効にすることができます。写真ブースで使用されるGUIには、 ShowInPhotoBooth 属性が true に設定されています。詳細とサンプルコードは、GUI ビジビリティ を参照してください。

他のGUIを表示

このコールバックは、印刷が閉じられた後に実行され、全体の ScreenGuis またはその内の要素を再度有効にすることができます。写真ブースで使用されるGUIには、 ShowInPhotoBooth 属性が true に設定されています。詳細とサンプルコードは、GUI ビジビリティ を参照してください。