CaptureService
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
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 en los que se toma automáticamente una captura de pantalla para un usuario, y ese usuario luego puede guardar, compartir o eliminar la Captura de pantalla.
Resumen
Métodos
Toma una captura de pantalla y proporciona una temporal contentId para identificarla.
Invita al usuario a guardar capturas específicas en su galería.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Solicita al usuario que comparta una capturarde pantalla especificada.
Eventos
Se enciende inmediatamente antes de que comience una captura.
Incendios después de que termine una captura.
Se activa cuando el usuario guarda una capturar.
Propiedades
Métodos
CaptureScreenshot
Este método captura una captura de pantalla para el usuario pero no la guarda inmediatamente en su galería Capturas dentro del menú principal de la experiencia.En cambio, se crea un temporal contentId para identificar la nueva capturar.
El retorno de llamada onCaptureReady se puede usar para solicitar al usuario que guarde o comparta la captura de pantalla:
local CaptureService = game:GetService("CaptureService")
-- Referencia a un padre de etiqueta de imagen 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 devolución de llamada que se llama con el contentId de la nueva captura una vez que esté lista.
Devuelve
PromptSaveCapturesToGallery
Este método le pide al usuario que guarde las capturas de pantalla identificadas por el contentIds proporcionado en su galería Capturas dentro del menú principal de la experiencia.
Parámetros
Una función de devolución de llamada que se invocará con un diccionario que mapeará cada contentId a un booleano que indique si el usuario aceptó guardar esa capturar.
Devuelve
PromptShareCapture
Este método le pide al usuario que comparta la captura de pantalla identificada por la hoja de compartir proporcionada en su dispositivo usando la hoja de compartir nativa.
La imagen de captura se comparte junto con un enlace de invitación a la experiencia cuando se admite.No todos los dispositivos admiten incluir tanto una captura de pantalla como un enlace de invitación.
El launchData estará disponible en el campo launchData para los usuarios que se unan a través del enlazarde invitación.
Para evitar un error al llamar a este método, primero llama PolicyService:GetPolicyInfoForPlayerAsync() y comprueba que IsContentSharingAllowed es cierto en el diccionario devuelto.
Parámetros
Una cadena opcional para incluir como datos 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.
Devuelve
TakeCapture
Parámetros
Devuelve
Eventos
CaptureBegan
Este evento se activa justo antes de tomar una nueva captura de pantalla.Se puede utilizar para personalizar la experiencia de captura, por ejemplo, ocultando ciertos elementos de interfaz de usuario.
CaptureEnded
Este evento se activa después de que se complete la captura de una nueva captura de pantalla. Se puede usar 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 utilizar 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ó.