自撮りモード | 文書 - Roblox クリエーターハブ

プレイヤーはすでにスクリーンショットを取って、エクスペリエンスで楽しい瞬間を記念します。The 自撮りモード開発者モジュールは、チャットウィンドウやプレイヤーリストなしで、その瞬間をよりクリーンなメモリで記録することができます、フィルターエフェクト、他のキャラクターの隠し、ポーズをサポ

モジュール使用

インストール

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

从 the ビュータブで、ツールボックスを開き、クリエイターストアタブを選択します。
モデルソートが選択されていることを確認してから、すべてを表示ボタンをクリックして、カテゴリのための 1>ボタン1> をクリックします。
デバッグモジュールタイルを見つけてクリックします。
自撮りモードのモジュールを見つけ、クリックするか、3D ビューにドラッグアンドドロップします。
In the エクスプローラーウィンドウ, 全体の自撮りモードモデルを ServerScriptService に移動します。エクスペリエンスを実行すると、モジュールはさまざまなサービスに分配され、実行を開始します。

構成

モジュールはほとんどの使用ケースで機能するようにプリコンフィグされていますが、configure 機能を通じて簡単にカスタマイズできます。

In StarterPlayerScripts で、新しい LocalScript を作成し、 ConfigureSelfieMode に名前を変更します。

新しいスクリプトに以下のコードを挿入します。

ローカルスクリプト - 自撮りモードを構成
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.configure({
	disableCharacterMovement = true
})

キャラクターの移動

自撮りモードのときにプレイヤーのキャラクターを動かさないようにすると、メリットがあります。これは、disableCharacterMovement を configure コールで設定することで達成できます。

ローカルスクリプト - 自撮りモードを構成
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.configure({
	disableCharacterMovement = true
})

自撮りモードアクション

自撮りモードは、アクティブアクション、無効アクション、および 0>トグルアクション0> 機能のそれぞれを使用できます。それぞれのアクティブアクション、無効アクション、およびトグルアクション機能は、<

深度のフィールド

デフォルトで、自撮りモードは、プレイヤーがアクションを切り替えると、一般的な深度オフィールド効操作 (背景のぼかし) を表示します。

このエフェクトは、電話やタブレットなどのモバイルデバイスではレンダリングされません。たとえ、モバイルデバイスではレンダリングされないとしても、プレイヤー定 → グラフィック品質により深度オブフィールドをレンダリングする必要が

デフォルトのディファインドフィールドエフェクトを変更するには、depthOfFieldEffect を自分の DepthOfFieldEffect インスタンスに設定し、配置コールで自分の 2>Class.DepthOfFieldEffect2> を使用します。

ローカルスクリプト - 自撮りモードを構成
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

local customDepthOfField = Instance.new("DepthOfFieldEffect")
customDepthOfField.NearIntensity = 0
customDepthOfField.FarIntensity = 1
customDepthOfField.FocusDistance = 5
customDepthOfField.InFocusRadius = 5

SelfieMode.configure({
	depthOfFieldEffect = customDepthOfField
})

目をロックする

目をロックすると、プレイヤーのキャラクターが自撮りポーズを設定している間、カメラを見つめます。

ほかの人を非表示

デフォルトでは、他のキャラクターはプレイヤーのキャラクターの隣に表示されます。プレイヤーは、他の人を非表示ボタンをクリックすることで完璧なソロショットを得ることができます。トグルオンにすると、他のキャラクターはビューから消え、アクションがトグルオフされるまで隠されます。

フィルタ

フィルターアクションは、Pop、Soft、Antique、2> Cute2>、5> Dramatic5>、および8> Monochrome8> からプレセットフィルターを適用できます。

ポーズ

ポーズアクションは、オプションチア、クラッピング、ドルフィン、 2>フロス2>、 5>ギター5>、 8>ジャン

API リファレンス

タイプ

アクション

それぞれのアクションは、次のキーバリューのペアでディクトリに表現されます：

キー	タイプ	説明
name	文字列	ツールの説明で最初に表示され操作アクションの名前。
description	文字列	ツールのヒントの後に表示されるアクションの説明。
icon	文字列	操作クションのアイコンのアセット ID。
activeIcon	文字列	「アクティブ」状態のアクションのアイコンのアセット ID。子アクションでは使用できません。
actions	テーブル	オプションのサブアクションのリスト。これにより、さまざまな他のアクションのサブメニューを作成できます。
parent	アクション	アクショ操作の親; これは、サブアクションにのみ適用され、アクションに含まれるアクションのポイントにのみ適用されます。
onActivated	機能	プレイヤーがアクションまたはサブアクションを有効にすると実行されるオプションのコールバック機能。通常、アクションに子アクションが含まれている場合、子アクションのみがコールバックを定義して、プレイヤーが子アクションを「拡張」しなかったことを知るための手段として実行されます。

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

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

SelfieMode.actionActivated:Connect(function(action)
	print(action.name, "activated")
end)

SelfieMode.actionDeactivated:Connect(function(action)
	print(action.name, "deactivated")
end)

エンラム

自撮りモード.アクション

自撮りモードは、複数のアクションを含みます。この枚数は、アクションを有効化、0>アクションを無効化0>、および 3>アクションを切り替え 3> 機能を使用することで使用できます。

名前	概要
DepthOfField	深度オブフィールドアクションに参照してくださ操作。
LockGaze	操作をロックするアクションに参照。
HideOthers	他の操作を非表示アクションに参照してください。
Filter	フィルターアクションに参照します。
Pose	ポーズアクションに参照。

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

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

-- 「フィルタ」アクション操作有効にする
SelfieMode.activateAction(SelfieMode.Action.Filter)

機能

環境設定

require(require: table )

Class.LocalScript テーブルの次のキー/値を通じて、デフォルトの設定オプションをオーバーライドします。この関数は LocalScript からのみ呼び出すことができます。

キー	説明	デフォルト
disableCharacterMovement	有効にすると、自撮りモードが開いている間、キャラクターが動くのを防ぐことができます。	偽
depthOfFieldEffect	プレイヤーが DepthOfFieldEffect アクションを切り替えると表示されるオプションのカスタム Class.DepthOfFieldEffect インスタン操作。

ローカルスクリプト - 自撮りモードを構成
local ReplicatedStorage = game:GetService("ReplicatedStorage")

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

SelfieMode.configure({
	disableCharacterMovement = true
})

自撮りモードを開く

openSelfieMode()

プレイヤーは通常、画面の右側にある「カメラ」ボタンで自撮りモードを開きますが、この機能を使用すると、コードで開くことができます。当該ボタンを実装するためには、setHudButtonEnabled を無効にする必要があります。この機能は、LocalScript からのみ呼び出すことができます。

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

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

local button = script.Parent

-- デフォルトのボタンを削除
SelfieMode.setHudButtonEnabled(false)

-- カスタムボタンを接続する
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

自撮りモードを閉じる

closeSelfieMode()

プレイヤーは通常、画面下部にある ⊗ ボタンで自撮りモードを閉じますが、この機能を使用すると、コードでそれを閉じることができます。LocalScript からのみ呼び出すことができます。

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

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

SelfieMode.closeSelfieMode()

isSelfieModeOpen

isSelfieModeOpen()： boolean

自撮りモードが開始された場合、true を返す。この機能は、 Class.LocalScript からのみ呼び出すことができる。

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

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

SelfieMode.openSelfieMode()

print(SelfieMode.isSelfieModeOpen())

setHudButtonEnabled を設定

setHudButtonEnabled()

デフォルトのボタンを自撮りモードに表示するかどうかを設定します。カスタム UI ボタンを通じて openSelfieMode を実装するのが便利です。この機能は LocalScript からのみ呼び出すことができます。

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

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

local button = script.Parent

-- デフォルトのボタンを削除
SelfieMode.setHudButtonEnabled(false)

-- カスタムボタンを接続する
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

getAction

getAction(操作ction: 自撮りモード.アクション): アクション

自撮りモードでアクションを取得する Action タイプを SelfieMode.Action 枚で取得します。

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

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

local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

アクションを有効にする

activeAction(操作ction: 自撮りモード.アクション )

デフォルトのアクションの 1 つをプログラムで有効にします。これは、プレイヤーがアクションバーからアクションを切り替えるときと同じです。LocalScript からのみ呼び出すことができます。

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

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

-- 「フィルタ」アクション操作有効にする
SelfieMode.activateAction(SelfieMode.Action.Filter)

deactivateAction

deactivateAction(操作ction: 自撮りモード.アクション )

デフォルトのアクションの 1 つをプログラムで無効にします。これは、プレイヤーがアクションバーからアクションをオフにするときと同じです。LocalScript からのみ呼び出すことができます。

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

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

-- 「フィルタ」アクション操作無効にする
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

トグルアクション

toggleAction(操作ction: 自撮りモード.アクション): boolean

アクションをオフにするか、オンにするかを切り替えます。これは、プレイヤーがアクションバーからアクションをクリックするときと同じです。新しい「is toggled on」状態をボールストリンクで返します。<a href="/resources/modules/reference/engine/datastores/datastores">データストア</a> からのみ呼び出すことができます。

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

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

local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)

local isEnabled = SelfieMode.toggleAction(lockGazeAction)

if isEnabled then
	print("Activated", lockGazeAction.name)
else
	print("Deactivated", lockGazeAction.name)
end

テーマを設定

setTheme(Theme: table )

テキストサイズ、フォント、ボタン/ヒントの色など、自撮りモードのテーマを構成します。この機能は LocalScript からのみ呼び出すことができます。

キー	説明	デフォルト
textSize	すべてのテキストのサイズ。	16
font	すべての UI ( :`Enums.Font` ）で使用されているフォント。	GothamMedium
padding	UI 要素を配置するために使用されるメインパッド ( UDim )。	(0、12)
paddingSmall	エレメント間の柔らかなマージを適用するために使用される小さなパッド ( UDim )。	（0、6）
paddingScreen	画面の端にパッドを使用して、自撮りモードに呼吸の余裕を与える( UDim )。	(0、24)
backgroundColor	アクションを表示するバーに使用される背景色 (Color3)。	[0, 0, 0]
scrollBarColor	モジュールの ScrollingFrame 要素のスクロールバーの色 ( Color3 )。	[255, 255, 255]

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

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

SelfieMode.setTheme({
	textSize = 20,
	font = Enum.Font.Michroma,
	backgroundColor = Color3.fromRGB(0, 40, 75),
})

setEnabled

setEnabled(isEnabled: boolean )

自撮りモードが有効かどうかを設定します。無効にすると、モジュールのすべての UI が削除され、すべてのイベントが接続されていなくなります。この機能は LocalScript からのみ呼び出すことができます。

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

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

SelfieMode.setEnabled(false)

イベント

自撮りモードが開きました

プレイヤーが自撮りモードを開始するとき、または自撮りモードを開くが呼び出されるときにファイアを起動します。このイベントは、LocalScript 内のみに接続できます。

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

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

SelfieMode.selfieModeOpened:Connect(function()
	print("Selfie mode open")
end)

自撮りモードを閉じる

プレイヤーが自撮りモードを閉じるか、selfieModeClose が呼び出されるときにファイアを起動します。このイベントは、LocalScript にのみ接続できます。

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

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

SelfieMode.selfieModeClosed:Connect(function()
	print("Selfie mode closed")
end)

アクションを有効にしました

パラメータ
操作クション: SelfieMode.Action	有効なアクション。

アクションが有効になると発動します; これは、深度 of field、lock gaze、またはHide Othersなどの主要なアクションの 1 つかもしれません; alternatively it may be a sub-action like a 2>フィルター

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

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

SelfieMode.actionActivated:Connect(function(action)
	print(action.name, "activated")
end)

actionDeactivated

パラメータ
操作クション: SelfieMode.Action	無効になったアクション。

主要アクションまたはサブアクションが無効になると、ファイアがトリガーされます。接続された関数は、無効になったアクションを受信します。このイベントは、LocalScript でのみ接続できます。

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

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

SelfieMode.actionDeactivated:Connect(function(action)
	print(action.name, "deactivated")
end)

フィルタ変更

パラメータ
newFilter: string	新しい並べ替えィルター。
古いフィルタ: string	前のフィルター。

フィルターが適用されたり、フィルターが削除されたりすると、接続された関数は新しいフィルター名と古いフィルター名を受信します。このイベントは、LocalScript でのみ接続できます。

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

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

SelfieMode.filterChanged:Connect(function(newFilter, oldFilter)
	print("Filter changed from", oldFilter, "to", newFilter)
end)

変更後のポーズ

パラメータ
新しいポーズ: string	新しいポーズ。
oldPose: string	前のポーズ。

ポーズが適用されたり削除されたりすると、LocalScript を受信する接続された関数。このイベントは、Class.LocalScript にのみ接続できます。

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

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

SelfieMode.poseChanged:Connect(function(newPose, oldPose)
	print("Pose changed from", oldPose, "to", newPose)
end)