Modalità Selfie

I giocatori già scattano screenshot per commemorare momenti divertenti nei giochi. Il modulo SelfieMode per sviluppatori consente ai giocatori di catturare un ricordo più pulito di quel momento senza la finestra della chat o l'elenco dei giocatori, supportando anche effetti di filtro, nascondendo altri personaggi e posando.

Utilizzo del Modulo

Installazione

Per utilizzare il modulo SelfieMode in un gioco:

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 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, oppure trascinalo nella vista 3D.

   

5. Nella finestra Esplora, sposta l'intero pacchetto SelfieMode in ReplicatedStorage. Una volta avviato il gioco, il modulo inizierà a funzionare.

Configurazione

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

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

2. Incolla il seguente codice nel nuovo script.

   LocalScript - ConfigureSelfieMode

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

Movimento del Personaggio

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

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.configure({
	disableCharacterMovement = true
})

Azioni della Modalità Selfie

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

Profondità di Campo

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

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

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
})

Blocca Sguardo

L'attivazione del toggle Blocca Sguardo fa sì che il personaggio del giocatore guardi la fotocamera mentre si prepara la posa selfie, all'interno di un intervallo realistico di quanto può ruotare il collo.

Nascondi Altri

Per impostazione predefinita, altri personaggi sono visibili insieme al personaggio del giocatore. I giocatori possono ottenere uno scatto perfetto da soli facendo clic sul pulsante Nascondi Altri. Quando attivato, gli altri personaggi svaniscono dalla vista e rimangono invisibili fino a quando 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:

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

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

Enum

SelfieMode.Action

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

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.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.configure({
	disableCharacterMovement = true
})

openSelfieMode

Un giocatore aprirà tipicamente la modalità selfie con il pulsante "camera" sul lato destro dello schermo, ma questa funzione ti 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.

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 chiuderà tipicamente la modalità selfie con il pulsante ⊗ in fondo allo schermo, ma questa funzione ti consente di chiuderla tramite codice. Può essere chiamata solo da un LocalScript.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.closeSelfieMode()

isSelfieModeOpen

Restituisce true se la modalità selfie è aperta a seguito di un'azione del giocatore o tramite openSelfieMode. Questa funzione può essere chiamata solo da un 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 è mostrato. Utile quando si implementa openSelfieMode tramite un pulsante UI personalizzato. Questa funzione può essere chiamata solo da un 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.

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 è lo stesso di quando un giocatore attiva l'azione dalla barra delle azioni. Può essere chiamata solo da un 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 è lo stesso di quando un giocatore disattiva l'azione dalla barra delle azioni. Può essere chiamata solo da un LocalScript.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

toggleAction

Attiva un'azione action se è spenta, o la disattiva se è accesa. Questo è lo stesso di quando un giocatore fa clic sull'azione dalla barra delle azioni. Restituisce il nuovo stato "è attivato su" come booleano. Può essere chiamata solo da un 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("Attivata", lockGazeAction.name)
else
	print("Disattivata", lockGazeAction.name)
end

setTheme

Configura il tema della modalità selfie, inclusi dimensione del testo, font, colori dei pulsanti/tooltips e altro. Questa funzione può essere chiamata solo da un 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.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

SelfieMode.setEnabled(false)

Eventi

selfieModeOpened

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

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

selfieModeClosed

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

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

actionActivated

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

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

actionDeactivated

Si attiva quando un'azione principale o una sotto-azione viene disattivata. La funzione connessa riceve l'Action disattivata. Questo evento può essere connesso solo in un LocalScript.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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

filterChanged

Si attiva 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.

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

Si attiva 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.

local ReplicatedStorage = game:GetService("ReplicatedStorage")

local SelfieMode = require(ReplicatedStorage.SelfieMode)

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