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 la façon dont la fonction de capture d'écran s'intègre à leurs expériences.Il peut être utilisé pour inclure des moments prédéfinis où une capture d'écran est prise automatiquement 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 temporaire contentId pour l'identifier.
Invite l'utilisateur à enregistrer les captures spécifiées dans sa galerie.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Demande à l'utilisateur de partager une capturerd'écran spécifiée.
Évènements
S'enflamme immédiatement avant le début d'une capture.
Feux après la fin d'une capture.
S'enflamme lorsque 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 sauvegarde pas immédiatement dans sa galerie captures dans le menu principal de l'expérience.Au lieu de cela, un temporaire contentId est créé pour identifier la nouvelle capturer.
Le rappel onCaptureReady peut être utilisé pour inciter l'utilisateur à enregistrer ou partager la capture d'écran :
local CaptureService = game:GetService("CaptureService")
-- Référence à un parent ImageLabel 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 invite l'utilisateur à enregistrer les captures d'écran identifiées par le contentIds fourni dans leur galerie Captures dans le menu principal de l'expérience.
Paramètres
Une fonction de rappel qui sera invoquée avec une carte de dictionnaire chaque contentId à un booléen indiquant si l'utilisateur a accepté de sauvegarder cette capturer.
Retours
PromptShareCapture
Cette méthode invite l'utilisateur à partager la capture d'écran identifiée par la feuille de partage fournie sur son appareil en utilisant la feuille de partage native.
L'image de capture est partagée avec un lien d'invitation à l'expérience lorsqu'elle est supportée.Pas tous les appareils supportent incluent à la fois une capture d'écran et un lierd'invitation.
Le launchData sera disponible dans le champ launchData pour les utilisateurs qui se joignent via le lierd'invitation.
Pour éviter une erreur lors de l'appel de cette méthode, appelez d'abord PolicyService:GetPolicyInfoForPlayerAsync() et vérifiez que IsContentSharingAllowed est vrai dans le dictionnaire renvoyé.
Paramètres
Une chaîne facultative à inclure comme données de lancement dans le lierd'invitation.
Une fonction de rappel facultative invoquée si l'utilisateur accepte le partage.
Une fonction de rappel facultative invoquée si l'utilisateur refuse de partager.
Retours
TakeCapture
Paramètres
Retours
Évènements
CaptureBegan
Cet événement se déclenche juste avant la capture d'une nouvelle capture d'écran.Il peut être utilisé pour personnaliser l'expérience de capture, par exemple en cachant certains éléments de l'interface utilisateur.
CaptureEnded
Cet événement se déclenche après la capture d'une nouvelle capture d'écran. Il peut être utilisé pour restaurer toutes 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 en utilisant l'interface de capture d'écran Roblox.Il peut être utilisé pour l'analyse ou pour inciter l'utilisateur à partager sa capturer.
Paramètres
Le contentId identifiant la capture d'écran que l'utilisateur a sauvegardée.