CaptureService

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

Non costruibile
Assistenza

CaptureService è un servizio lato client che consente agli sviluppatori di controllare come la funzione di cattura dello screenshot si integra con le loro esperienze.Può essere utilizzato per includere momenti predefiniti in cui viene eseguito automaticamente uno screenshot per un utente e quell'utente può quindi salvare, Condividereo eliminare lo screenshot.

Sommario

Metodi

Eventi

Proprietà

Metodi

CaptureScreenshot

()

Questo metodo cattura uno screenshot per l'utente ma non lo salva immediatamente nella loro galleria Catture all'interno del menu principale dell'esperienza.Invece, viene creato un temporaneo contentId per identificare la nuova cattura testo.

Il richiamo onCaptureReady può essere utilizzato per richiedere all'utente di salvare o condividere lo screenshot:


local CaptureService = game:GetService("CaptureService")
-- Riferimento a un ImageLabel padre dello script contenente questo codice
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)

Parametri

onCaptureReady: function

Una funzione di richiamo che viene chiamata con il contentId della nuova cattura una volta che è pronta.

Valore predefinito: ""

Restituzioni

()

PromptSaveCapturesToGallery

()

Questo metodo richiede all'utente di salvare gli screenshot identificati dal contentIds fornito nella loro galleria Cattura all'interno del menu principale dell'esperienza.

Parametri

captures: Array
Valore predefinito: ""
resultCallback: function

Una funzione di richiamo che verrà invocata con una mappa di dizionario ogni contentId a un boolean che indica se l'utente ha accettato di salvare quella cattura testo.

Valore predefinito: ""

Restituzioni

()

PromptShareCapture

()

Questo metodo richiede all'utente di condividere lo screenshot identificato dal fornito contentId utilizzando la scheda di condivisione nativa sul loro Dispositivo.

L'immagine di cattura viene condivisa insieme a un link di invito all'esperienza quando supportata.Non tutti i dispositivi supportano inclusione sia di uno screenshot che di un Callegaredi invito.

Il launchData sarà disponibile nel campo launchData per gli utenti che si uniscono attraverso il Callegaredi invito.

Per evitare un errore durante l'esecuzione di questo metodo, chiama prima PolicyService:GetPolicyInfoForPlayerAsync() e controlla che IsContentSharingAllowed sia vero nel dizionario restituito.

Parametri

captureContent: Content
Valore predefinito: ""
launchData: string

Una stringa opzionale da includere come dati di lancio nel Callegaredi invito.

Valore predefinito: ""
onAcceptedCallback: function

Una funzione di richiamo opzionale invocata se l'utente accetta la condivisione.

Valore predefinito: ""
onDeniedCallback: function

Una funzione di richiamo opzionale invocata se l'utente rifiuta la condivisione.

Valore predefinito: ""

Restituzioni

()

TakeCapture

()

Parametri

onCaptureReady: function
Valore predefinito: ""
captureParams: Dictionary
Valore predefinito: "nil"

Restituzioni

()

Eventi

CaptureBegan

Questo evento si attiva poco prima che venga eseguita una nuova cattura di schermata.Può essere utilizzato per personalizzare l'esperienza di cattura, ad esempio nascondendo determinati elementi GUI.


CaptureEnded

Questo evento si attiva dopo che una nuova cattura di schermo è completata. Può essere utilizzato per ripristinare qualsiasi modifica effettuata quando l'evento CaptureBegan è stato attivato.


UserCaptureSaved

Questo evento si attiva quando l'utente salva uno screenshot utilizzando l'interfaccia utente di cattura dello screenshot di Roblox.Può essere utilizzato per l'analisi o per richiedere all'utente di condividere la sua cattura testo.

Parametri

captureContentId: ContentId

Il contentId identifica lo screenshot che l'utente ha salvato.