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 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
Proprietà
Metodi
Fa uno screenshot e fornisce un temporaneo contentId per identificarlo.
Invita l'utente a salvare le catture specificate nella loro galleria.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Invita l'utente a condividere una cattura testodi schermo specificata.
Eventi
Si accende immediatamente prima che inizi una cattura.
Fuochi dopo che una cattura finisce.
Si accende 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 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
Una funzione di richiamo che viene chiamata con il contentId della nuova cattura una volta che è pronta.
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
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.
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
Una stringa opzionale da includere come dati di lancio nel Callegaredi invito.
Una funzione di richiamo opzionale invocata se l'utente accetta la condivisione.
Una funzione di richiamo opzionale invocata se l'utente rifiuta la condivisione.
Restituzioni
TakeCapture
Parametri
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
Il contentId identifica lo screenshot che l'utente ha salvato.