CaptureService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
CaptureService es un servicio de lado del cliente que permite a los desarrolladores controlar cómo se integra la función de captura de pantalla con sus experiencias. Se puede utilizar para incluir momentos predeterminados donde se toma automáticamente una captura de pantalla para un usuario, y ese usuario puede luego guardar, compartir o eliminar la Captura de pantalla.
Resumo
Métodos
Toma una captura de pantalla y proporciona un temporal contentId para identificarlo.
Solicita al usuario que guarde capturas específicas en su galería.
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
Solicita al usuario que comparta una capturarde pantalla especificada.
Eventos
Dispara inmediatamente antes de que comience una captura.
Dispara después de que termine una captura.
Se activa cuando el usuario guarda una capturar.
Propriedades
Métodos
CaptureScreenshot
Este método captura una captura de pantalla para el usuario, pero no se guarda inmediatamente en su galería de Capturas dentro del menú principal de la experiencia. En cambio, se crea un temporal contentId para identificar la nueva capturar.
El onCaptureReady llamado de retorno se puede usar para solicitar al usuario que guarde o comparta la Captura de pantalla:
local CaptureService = game:GetService("CaptureService")
-- Referencia a un ImageLabel padre del script que contiene este código
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parâmetros
Una función de llamada que se llama con el contentId de la nueva captura una vez que esté lista.
Devolução
PromptSaveCapturesToGallery
Este método solicita al usuario guardar los capturas de pantalla identificadas por el proveedor contentIds en su galería Capturas dentro del menú principal de la experiencia.
Parâmetros
Un arreglo de contentId cuerdas que identifican las capturas de pantalla para guardar.
Una función de llamada que se invocará con un mapa de diccionario cada contentId a unBooleano que indica si el usuario aceptó guardar que capturar.
Devolução
PromptShareCapture
Este método solicita al usuario compartir la captura de pantalla identificada por el contentId proporcionado usando la hoja de compartir nativa en su dispositivo.
La imagen de captura se compartirá junto con un enlace de invitación a la experiencia cuando se admita. No todos los dispositivos/ apps admiten ambos una captura de pantalla y un enlazarde invitación.
El launchData estará disponible en el campo launchData para los usuarios que se unan a través del enlazarde invitación.
Parâmetros
El contentId que identifica la captura de pantalla para compartir.
Una cadena opcional para incluir como dato de lanzamiento en el enlazarde invitación.
Una función de llamada opcional invocada si el usuario acepta compartir.
Una función de llamada opcional invocada si el usuario rechaza compartir.
Devolução
Eventos
CaptureBegan
Este evento se activa justo antes de que se tome una nueva captura de pantalla. Se puede usar para personalizar la experiencia de captura, por ejemplo, ocultando ciertos elementos de la GUI.
CaptureEnded
Este evento se activa después de que se complete una nueva captura de pantalla. Se puede utilizar para restaurar cualquier cambio realizado cuando se activó el evento CaptureBegan.
UserCaptureSaved
Este evento se activa cuando el usuario guarda una captura de pantalla usando la interfaz de usuario de captura de pantalla de Roblox. Se puede usar para el análisis o para solicitar al usuario que comparta su capturar.
Parâmetros
El contentId que identifica la captura de pantalla que el usuario guardó.