CaptureService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
CaptureService è un servizio lato client che consente agli sviluppatori di controllare in che modo la funzione di cattura dello screenshot si integra con le loro esperienze. Può essere utilizzato per includere momenti preimpostati in cui viene automaticamente presa una foto dello schermo per un utente, e quell'utente può quindi salvare, Condividereo eliminare la foto dello schermo.
Sommario
Proprietà
Metodi
Fa uno screenshot e fornisce un temporaneo contentId per identificarlo.
Invita l'utente a salvare le catture specifiche nella sua galleria.
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
Richiede all'utente di condividere una cattura testodi schermo specificata.
Eventi
Spara immediatamente prima che inizi una cattura.
Si attiva dopo la fine di una cattura.
Si attiva quando l'utente salva una cattura testo.
Proprietà
Metodi
CaptureScreenshot
Questo metodo cattura uno screenshot per l'utente ma non lo salva immediatamente nella loro galleria Captures all'interno del menu principale dell'esperienza. Invece, viene creato temporaneamente un contentId per identificare la nuova cattura testo.
Il onCaptureReady callback 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 che contiene questo codice
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parametri
Una funzione di richiamata che è chiamata con il contentId della nuova cattura una volta che è pronta.
Restituzioni
PromptSaveCapturesToGallery
Questo metodo richiede all'utente di salvare le schermate identificate dal contentIds fornito nella loro galleria Captures principale menu dell'esperienza.
Parametri
Un array di contentId stringhe che identificano gli screenshot da salvare.
Una funzione di richiamata che verrà invocata con una mappa del dizionario ogni contentId a un booleto che indica se l'utente ha accettato di salvare quell'cattura testo.
Restituzioni
PromptShareCapture
Questo metodo richiede all'utente di condividere lo screenshot identificato dall'contentId fornito utilizzando la pagina di condivisione nativa sul loro Dispositivo.
L'immagine di captura verrà condivisa insieme a un link all'esperienza quando supportato. Non tutti i dispositivi/app supportano incluso uno screenshot e un Callegareall'esperienza.
Il launchData sarà disponibile nel campo launchData per gli utenti che si uniscono tramite il Callegaredi invito.
Parametri
Il contentId che identifica lo screenshot da Condividere.
Una stringa opzionale da includere come dati di avvio nel Callegaredi invito.
Una funzione richiamata opzionale se l'utente accetta la condivisione.
Una funzione richiamata opzionale se l'utente rifiuta la condivisione.
Restituzioni
Eventi
CaptureBegan
Questo evento si attiva proprio prima di un nuovo catturare lo schermo. Può essere utilizzato per personalizzare l'esperienza di catturare, ad esempio nascondendo alcuni elementi GUI.
CaptureEnded
Questo evento si attiva dopo che una nuova cattura di schermo completata. Può essere utilizzato per ripristinare qualsiasi cambiamento apportato quando l'evento CaptureBegan è stato attivato.
UserCaptureSaved
Questo evento si attiva quando l'utente salva uno screenshot utilizzando la UI di cattura dello screenshot Roblox. Può essere utilizzato per l'analisi o per invitare l'utente a condividere la loro cattura testo.
Parametri
Il contentId che identifica lo screenshot che l'utente ha salvato.