自撮りモード

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

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

モジュール使用

インストール

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

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

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

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

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

  5. In the エクスプローラー ウィンドウ, 全体の 自撮りモード モデルを ServerScriptService に移動します。エクスペリエンスを実行すると、モジュールはさまざまなサービスに分配され、実行を開始します。

構成

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

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

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

    ローカルスクリプト - 自撮りモードを構成

    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
paddingUI 要素を配置するために使用されるメインパッド ( 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)