Modalità Selfie

I giocatori già acquisiscono screenshot per commemorare momenti divertenti nelle esperienze. Il modulo SelfieMode per sviluppatori consente ai giocatori di catturare una memoria più pulita di quel momento senza la finestra di chat o la lista dei giocatori, supportando anche effetti filtranti, nascondendo altri personaggi e posando.

Utilizzo del Modulo

Installazione

Per utilizzare il modulo SelfieMode in un'esperienza:

1. Dal menu Finestra di Studio o dalla barra degli strumenti della scheda Home, apri il Toolbox e seleziona la scheda Creator Store.

   

2. Assicurati che sia selezionato l'ordinamento per Modelli, quindi fai clic sul pulsante Vedi Tutti per Categorie.

   

3. Individua e fai clic sulla tessera Pacchetti.

4. Individua il modulo Modalità Selfie e fai clic su di esso o trascinalo nella vista 3D.

   

5. Nella finestra Explorer, sposta l'intero pacchetto SelfieMode in ReplicatedStorage. Una volta avviata l'esperienza, il modulo inizierà a funzionare.

Configurazione

Il modulo è preconfigurato per funzionare per la maggior parte dei casi d'uso, ma puoi personalizzarlo facilmente attraverso la funzione configure.

1. In StarterPlayerScripts, crea un nuovo LocalScript e rinominalo in ConfiguraSelfieMode.

2. Incolla il seguente codice nel nuovo script.

   LocalScript - ConfiguraSelfieMode
   local ReplicatedStorage = game:GetService("ReplicatedStorage")
   
   local SelfieMode = require(ReplicatedStorage.SelfieMode)
   
   SelfieMode.configure({
   	disableCharacterMovement = true
   })

Movimento del Personaggio

Può essere vantaggioso impedire al personaggio del giocatore di muoversi mentre si è in modalità selfie. Puoi ottenere questo impostando disableCharacterMovement su true in una chiamata a configure.

LocalScript - ConfiguraSelfieMode
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.configure({
	disableCharacterMovement = true
})

Azioni della Modalità Selfie

SelfieMode include le seguenti azioni, ciascuna delle quali puoi utilizzare con le funzioni activateAction, deactivateAction e toggleAction, o rilevare tramite gli eventi actionActivated e actionDeactivated.

Profondità di Campo

Di default, SelfieMode mostra un effetto generico di profondità di campo (sfocatura sottile dello sfondo) quando un giocatore attiva l'azione.

Per modificare l'effetto di profondità di campo predefinito, imposta depthOfFieldEffect su una tua istanza di DepthOfFieldEffect in una chiamata configure.

LocalScript - ConfiguraSelfieMode
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

SelfieMode.configure({
	depthOfFieldEffect = customDepthOfField
})

Fissa Sguardo

L'attivazione della Fissa Sguardo fa sì che il personaggio del giocatore guardi verso la fotocamera mentre imposta la posa selfie, all'interno di un intervallo realistico su quanto possa muoversi il collo.

Nascondi Altri

Di default, altri personaggi sono visibili accanto al personaggio del giocatore. I giocatori possono ottenere uno scatto perfetto da soli cliccando sul pulsante Nascondi Altri. Quando attivato, gli altri personaggi svaniscono dalla vista e restano invisibili finché l'azione non viene disattivata.

Filtro

L'azione Filtro consente al giocatore di applicare un filtro preimpostato tra le opzioni Pop, Soft, Antique, Cute, Dramatic e Monochrome.

Posa

L'azione Posa consente al giocatore di selezionare una posa preimpostata tra le opzioni Cheer, Clapping, Dolphin, Flossing, Guitar, Jump Wave, Louder, Top Rock, Twirl e Wave.

Riferimento API

Tipi

Azione

Ogni azione è rappresentata da un dizionario con le seguenti coppie chiave-valore:

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

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

Enum

SelfieMode.Action

SelfieMode include diverse azioni. Puoi utilizzare questo enum con le funzioni activateAction, deactivateAction e toggleAction.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

-- Attiva l'azione "Filtro"
SelfieMode.activateAction(SelfieMode.Action.Filter)

Funzioni

configure

Sovrascrive le opzioni di configurazione predefinite tramite le seguenti chiavi/valori nella tabella config. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript - ConfiguraSelfieMode
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.configure({
	disableCharacterMovement = true
})

openSelfieMode

Un giocatore tipicamente aprirà la modalità selfie utilizzando il pulsante "fotocamera" sul lato destro dello schermo, ma questa funzione consente di aprirla tramite codice. Quando implementi un pulsante personalizzato come mostrato di seguito, dovresti disabilitare il pulsante predefinito tramite setHudButtonEnabled. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

local button = script.Parent

-- Rimuovi il pulsante predefinito
SelfieMode.setHudButtonEnabled(false)

-- Collega il pulsante personalizzato
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

closeSelfieMode

Un giocatore tipicamente chiuderà la modalità selfie utilizzando il pulsante ⊗ nella parte inferiore dello schermo, ma questa funzione consente di chiuderla tramite codice. Può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.closeSelfieMode()

isSelfieModeOpen

Restituisce true se la modalità selfie è aperta a causa di un'azione del giocatore o tramite openSelfieMode. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.openSelfieMode()

print(SelfieMode.isSelfieModeOpen())

setHudButtonEnabled

Imposta se il pulsante predefinito per entrare in modalità selfie viene mostrato. Utile quando si implementa openSelfieMode tramite un pulsante UI personalizzato. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

local button = script.Parent

-- Rimuovi il pulsante predefinito
SelfieMode.setHudButtonEnabled(false)

-- Collega il pulsante personalizzato
button.Activated:Connect(function()
	SelfieMode.openSelfieMode()
end)

getAction

Ottiene un tipo Action tramite un enum SelfieMode.Action.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

activateAction

Attiva programmaticamente una delle azioni predefinite. Questo è equivalente a quando un giocatore attiva l'azione dalla barra delle azioni. Può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

-- Attiva l'azione "Filtro"
SelfieMode.activateAction(SelfieMode.Action.Filter)

deactivateAction

Disattiva programmaticamente una delle azioni predefinite. Questo è equivalente a quando un giocatore disattiva l'azione dalla barra delle azioni. Può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

-- Disattiva l'azione "Filtro"
SelfieMode.deactivateAction(SelfieMode.Action.Filter)

toggleAction

Alterna un'azione (selfie-mode-actions) attivandola se è spenta, o disattivandola se è accesa. Questo è equivalente a quando un giocatore clicca sull'azione dalla barra delle azioni. Restituisce il nuovo stato "è attivato su" come booleano. Può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

local isEnabled = SelfieMode.toggleAction(lockGazeAction)

if isEnabled then
	print("Attivato", lockGazeAction.name)
else
	print("Disattivato", lockGazeAction.name)
end

setTheme

Configura il tema della modalità selfie, inclusa la dimensione del testo, il font, i colori dei pulsanti/tooltips e altro. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

setEnabled

Imposta se la modalità selfie è abilitata o meno. Quando disabilitata, tutta l'interfaccia utente per il modulo viene rimossa e tutti gli eventi vengono disconnessi. Questa funzione può essere chiamata solo da un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.setEnabled(false)

Eventi

selfieModeOpened

Viene attivato quando il giocatore apre la modalità selfie o quando viene chiamato openSelfieMode. Questo evento può essere connesso solo in un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.selfieModeOpened:Connect(function()
	print("Modalità selfie aperta")
end)

selfieModeClosed

Viene attivato quando il giocatore chiude la modalità selfie o quando viene chiamato closeSelfieMode. Questo evento può essere connesso solo in un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.selfieModeClosed:Connect(function()
	print("Modalità selfie chiusa")
end)

actionActivated

Viene attivato quando un'azione viene attivata; questa può essere una delle azioni principali come Profondità di Campo, Fissa Sguardo o Nascondi Altri; alternativamente può essere una sub-azione come un filtro o una posa. La funzione connessa riceve l'azione Action attivata. Questo evento può essere connesso solo in un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

actionDeactivated

Viene attivato quando un'azione principale o sub-azione viene disattivata. La funzione connessa riceve l'azione Action disattivata. Questo evento può essere connesso solo in un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

filterChanged

Viene attivato quando un filtro viene applicato o rimosso. La funzione connessa riceve il nome del nuovo filtro e il nome del filtro precedente. Questo evento può essere connesso solo in un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.filterChanged:Connect(function(newFilter, oldFilter)
	print("Filtro cambiato da", oldFilter, "a", newFilter)
end)

poseChanged

Viene attivato quando una posa viene applicata o rimossa. La funzione connessa riceve il nome della nuova posa e il nome della posa precedente. Questo evento può essere connesso solo in un LocalScript.

LocalScript
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.poseChanged:Connect(function(newPose, oldPose)
	print("Posa cambiata da", oldPose, "a", newPose)
end)