プレイヤーはすでにスクリーンショットを取って、エクスペリエンスで楽しい瞬間を記念します。The 自撮りモード 開発者モジュール は、チャットウィンドウやプレイヤーリストなしで、その瞬間をよりクリーンなメモリで記録することができます、フィルターエフェクト、他のキャラクターの隠し、ポーズをサポ
モジュール使用
インストール
エクスペリエンスで SelfieMode モジュールを使用するには:
モデル ソートが選択されていることを確認してから、 すべてを表示 ボタンをクリックして、 カテゴリ のための 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 = 0customDepthOfField.FarIntensity = 1customDepthOfField.FocusDistance = 5customDepthOfField.InFocusRadius = 5SelfieMode.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)
機能
環境設定
Class.LocalScript テーブルの次のキー/値を通じて、デフォルトの設定オプションをオーバーライドします。この関数は LocalScript からのみ呼び出すことができます。
キー | 説明 | デフォルト |
---|---|---|
disableCharacterMovement | 有効にすると、自撮りモードが開いている間、キャラクターが動くのを防ぐことができます。 | 偽 |
depthOfFieldEffect | プレイヤーが DepthOfFieldEffect アクションを切り替えると表示されるオプションのカスタム Class.DepthOfFieldEffect インスタン操作。 |
ローカルスクリプト - 自撮りモードを構成
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))SelfieMode.configure({disableCharacterMovement = true})
自撮りモードを開く
プレイヤーは通常、画面の右側にある「カメラ」ボタンで自撮りモードを開きますが、この機能を使用すると、コードで開くことができます。当該ボタンを実装するためには、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)
自撮りモードを閉じる
プレイヤーは通常、画面下部にある ⊗ ボタンで自撮りモードを閉じますが、この機能を使用すると、コードでそれを閉じることができます。LocalScript からのみ呼び出すことができます。
ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))SelfieMode.closeSelfieMode()
isSelfieModeOpen
自撮りモードが開始された場合、true を返す。この機能は、 Class.LocalScript からのみ呼び出すことができる。
ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))SelfieMode.openSelfieMode()print(SelfieMode.isSelfieModeOpen())
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
自撮りモードでアクションを取得する Action タイプを SelfieMode.Action 枚で取得します。
ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))local lockGazeAction = SelfieMode.getAction(SelfieMode.Action.LockGaze)
アクションを有効にする
デフォルトの アクション の 1 つをプログラムで有効にします。これは、プレイヤーがアクションバーからアクションを切り替えるときと同じです。LocalScript からのみ呼び出すことができます。
ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))-- 「フィルタ」アクション操作有効にするSelfieMode.activateAction(SelfieMode.Action.Filter)
deactivateAction
デフォルトの アクション の 1 つをプログラムで無効にします。これは、プレイヤーがアクションバーからアクションをオフにするときと同じです。LocalScript からのみ呼び出すことができます。
ローカルスクリプト
local ReplicatedStorage = game:GetService("ReplicatedStorage")local SelfieMode = require(ReplicatedStorage:WaitForChild("SelfieMode"))-- 「フィルタ」アクション操作無効にするSelfieMode.deactivateAction(SelfieMode.Action.Filter)
トグルアクション
アクションをオフにするか、オンにするかを切り替えます。これは、プレイヤーがアクションバーからアクションをクリックするときと同じです。新しい「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 thenprint("Activated", lockGazeAction.name)elseprint("Deactivated", lockGazeAction.name)end
テーマを設定
テキストサイズ、フォント、ボタン/ヒントの色など、自撮りモードのテーマを構成します。この機能は 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
自撮りモードが有効かどうかを設定します。無効にすると、モジュールのすべての 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)
フィルタ変更
フィルターが適用されたり、フィルター が削除されたりすると、接続された関数は新しいフィルター名と古いフィルター名を受信します。このイベントは、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)
変更後のポーズ
ポーズ が適用されたり削除されたりすると、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)