CaptureService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
CaptureService est un service côté client qui permet aux développeurs de contrôler comment la capture d'écran intègre avec leurs expériences. Il peut être utilisé pour inclure des moments prédéfinis où une capture d'écran est automatiquement prise pour un utilisateur, et que cet utilisateur peut ensuite enregistrer, partager ou supprimer la capture d'écran.
Résumé
Méthodes
Prend une capture d'écran et fournit un contentId.
Invite l'utilisateur à enregistrer les captures spécifiées dans sa galerie.
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
Invite l'utilisateur à partager une capturerd'écran spécifiée.
Évènements
Tire immédiatement avant le début d'une capture.
Tire après la fin d'une capture.
Tire quand l'utilisateur enregistre une capturer.
Propriétés
Méthodes
CaptureScreenshot
Cette méthode capture une capture d'écran pour l'utilisateur mais ne la sauve pas immédiatement dans leur galerie Captures dans le menu principal de l'expérience. Au lieu de cela, un temporaire contentId est créé pour identifier la nouvelle capturer.
La fonctionnalité onCaptureReady peut être utilisée pour inviter l'utilisateur à enregistrer ou à partager la capture d'écran :
local CaptureService = game:GetService("CaptureService")
-- Référence à un ImageLabel parent du script contenant ce code
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Paramètres
Une fonction de rappel qui est appelée avec le contentId de la nouvelle capture une fois qu'elle est prête.
Retours
PromptSaveCapturesToGallery
Cette méthode demande à l'utilisateur de sauvegarder les captures d'écran identifiées par le contentIds fourni dans leur Captures galerie dans le menu principal de l'expérience.
Paramètres
Un tableau de contentId строк identifiant les captures d'écran à enregistrer.
Une fonction de rappel qui sera invoquée avec une mappe de dictionnaire à chaque contentId à un booléen indiquant si l'utilisateur a accepté d'enregistrer ce capturer.
Retours
PromptShareCapture
Cette méthode demande à l'utilisateur de partager la capture d'écran identifiée par le contentId fourni en utilisant la feuille de partage native sur leur appareil.
L'image de capture sera partagée avec un lien d'invitation à l'expérience lorsqu'elle est prise en charge. Les appareils/ applications ne supportent pas tous les deux l'invitation à l'écran et le lierd'invitation.
Les launchData seront disponibles dans le champ launchData pour les utilisateurs qui rejoignent via le lierd'invitation.
Paramètres
Le contentId identifiant la capture d'écran à partager.
Une chaîne facultative à inclure dans les données de lancement dans le lierd'invitation.
Une fonction d'appel facultative invoquée si l'utilisateur accepte le partage.
Une fonction d'appel facultative invoquée si l'utilisateur refuse de partager.
Retours
Évènements
CaptureBegan
Cet événement se déclenche juste avant qu'une nouvelle capture d'écran soit prise. Il peut être utilisé pour personnaliser l'expérience de capture, par exemple en cachant certains éléments de l'interface graphique.
CaptureEnded
Cet événement se déclenche après la capture d'un nouveau captulo d'écran. Il peut être utilisé pour restaurer les modifications apportées lorsque l'événement CaptureBegan a été déclenché.
UserCaptureSaved
Cet événement se déclenche lorsque l'utilisateur enregistre une capture d'écran à l'aide de l'interface de capture d'écran Roblox. Il peut être utilisé pour l'analyse ou pour inviter l'utilisateur à partager leur capturer.
Paramètres
Le contentId identifiant la capture d'écran que l'utilisateur a enregistrée.