Personalizza la fotocamera | Documentazione

La fotocamera integrata di Roblox alimenta una modalità terza persona predefinita e una modalità prima persona opzionale, quindi non è necessario costruire una propria fotocamera seguente. Per scenari più personalizzati, puoi regolare le proprietà predefinite in Camera o sostituirla completamente, come per le visuali sopra la spalla, isometriche e di mira delle armi.

Impostazioni di base

Puoi configurare le impostazioni comuni della fotocamera direttamente all'interno dell'oggetto StarterPlayer di Studio. Queste impostazioni includono la distanza di zoom e varie modalità di fotocamera, occlusione e movimento.

Nella finestra Explorer, seleziona l'oggetto StarterPlayer.
Nella finestra Properties, scorri verso il basso per individuare la sezione Camera. Puoi configurare le seguenti proprietà direttamente o tramite uno script.

Distanza di zoom

Insieme a CameraMaxZoomDistance e CameraMinZoomDistance, imposti l'intervallo in cui i giocatori possono zoomare la fotocamera rispetto al loro personaggio. Impostare un massimo molto alto come 500 consente ai giocatori di zoomare la fotocamera molto lontano nello spazio. Se desideri bloccare la fotocamera a una distanza specifica dal personaggio e impedire lo zoom, imposta entrambe queste proprietà allo stesso valore.

LocalScript - Intervallo di zoom della fotocamera

local Players = game:GetService("Players")

local player = Players.LocalPlayer

player.CameraMaxZoomDistance = 25
player.CameraMinZoomDistance = 50

Modalità fotocamera

La proprietà CameraMode imposta il comportamento generale della fotocamera tra due opzioni:

Impostazione	Descrizione
Classico	La fotocamera classica di Roblox in terza persona che può essere ingrandita in prima persona. Consente ai giocatori di zoomare avanti e indietro (a meno che lo zoom non sia bloccato) e ruotare la fotocamera attorno al loro personaggio.
BloccaPrimaPersona	Blocca la fotocamera in modalità prima persona. Quando si è in questa modalità, tutte le parti/elementi del personaggio del giocatore sono invisibili per loro, tranne gli Tools equipaggiati.

Modalità occlusione

La proprietà DevCameraOcclusionMode controlla il comportamento della fotocamera quando il giocatore non può vedere il proprio personaggio, ad esempio quando è oscurato da un BasePart.

Impostazione	Descrizione
Zoom	Se il personaggio del giocatore si muove dietro un oggetto con Transparency inferiore a 0.25, la fotocamera si zooma molto vicino al personaggio in modo che possa essere visto. Una volta che il personaggio si sposta di nuovo in una posizione visibile, la fotocamera si zooma di nuovo indietro.
Invisicam	Se il personaggio del giocatore si muove dietro un oggetto con Transparency inferiore a 0.75, la fotocamera rimane immobile ma l'oggetto diventa semi-trasparente in modo che il personaggio possa essere visto. Una volta che il personaggio si sposta di nuovo in una posizione visibile, l'oggetto torna alla sua opacità normale.

Modalità di occlusione Zoom e Invisicam

Modalità movimento

La proprietà DevComputerCameraMovementMode (computer) e DevTouchCameraMovementMode (telefono/tablet) determinano come il giocatore può muovere la fotocamera.

Impostazione	Descrizione
SceltaUtente	La fotocamera si muoverà in base alle impostazioni della fotocamera in-game del giocatore.
Classico	La fotocamera rimane alla sua distanza di zoom, seguendo il personaggio del giocatore mentre si muove nel mondo. I giocatori possono anche inclinare la vista della fotocamera su/giù e orbitarla attorno al loro personaggio.
Segui	Simile a Classico ma la fotocamera può ruotare leggermente per affrontare il personaggio del giocatore se si muove in una direzione che non è parallela alla direzione in cui la fotocamera sta guardando.
Orbitale	La fotocamera rimane a una distanza di zoom fissa e segue il personaggio del giocatore mentre si muove nel mondo. I giocatori possono orbitare la fotocamera attorno al loro personaggio ma non possono inclinare la vista su o giù.
CameraToggle	Funziona solo sui computer (non su telefoni/tablet) tramite DevComputerCameraMovementMode. Quando il giocatore fa clic con il pulsante destro del mouse, la fotocamera passa dalla modalità Classico a una modalità di "visione libera" in cui muovendo il mouse si guarda attorno al mondo.

Scriptare la fotocamera

Ogni client del giocatore ha il proprio oggetto Camera che risiede nel Workspace locale, accessibile tramite la proprietà Workspace.CurrentCamera. Puoi sovrascrivere gli script predefiniti della fotocamera di Roblox impostando il suo CameraType su Scriptable e poi, più comunemente, controllare la fotocamera tramite le seguenti proprietà.

Proprietà	Descrizione
Camera.CFrame	Il CFrame della fotocamera. Questa è la proprietà più frequentemente utilizzata per posizionare e orientare una fotocamera Scriptable in un gioco.
Camera.FieldOfView	L'estensione dello spazio 3D osservabile che può essere vista sullo schermo, misurata tra 1–120 gradi nella direzione definita da Camera.FieldOfViewMode. Il valore predefinito è 70.
Camera.CameraType	Alterna tra i vari comportamenti della fotocamera delineati in Enum.CameraType, alcuni dei quali imitano le modalità di movimento selezionabili. Impostare questo su Scriptable ti dà il pieno controllo della fotocamera.
Camera.Focus	Il punto nello spazio 3D in cui la fotocamera sta guardando. Se hai impostato Camera.CameraType su Scriptable, dovresti aggiornare questa proprietà ad ogni frame perché alcuni effetti visivi sono più dettagliati a seconda di quanto siano vicini al punto di messa a fuoco.