CaptureService

Show Deprecated
Not Creatable
Service

CaptureService is a client-side service that allows developers to control how the screenshot capture feature integrates with their experiences. It can be used to include preset moments where a screenshot is automatically taken for a user, and that user can then save, share, or delete the screenshot.

Summary

Methods

Events

Properties

Methods

CaptureScreenshot

void

This method captures a screenshot for the user but does not immediately save it to their Captures gallery within the experience's main menu. Instead, a temporary contentId is created to identify the new capture.

The onCaptureReady callback can be used to prompt the user to save or share the screenshot.

Parameters

onCaptureReady: function

A callback function that is called with the contentId of the new capture once it is ready.


Returns

void

PromptSaveCapturesToGallery

void

This method prompts the user to save the screenshots identified by the provided contentIds to their Captures gallery within the experience's main menu.

Parameters

contentIds: Array

An array of contentId strings identifying the screenshots to save.

resultCallback: function

A callback function that will be invoked with a dictionary mapping each contentId to a boolean indicating if the user accepted saving that capture.


Returns

void

PromptShareCapture

void

This method prompts the user to share the screenshot identified by the provided contentId using the native share sheet on their device.

The capture image will be shared along with an invite link to the experience when supported. Not all devices/apps support including both a screenshot and invite link.

The launchData will be available in the launchData field for users who join through the invite link.

Parameters

contentId: ContentId

The contentId identifying the screenshot to share.

launchData: string

An optional string to include as launch data in the invite link.

onAcceptedCallback: function

An optional callback function invoked if the user accepts sharing.

onDeniedCallback: function

An optional callback function invoked if the user denies sharing.


Returns

void

Events

CaptureBegan

This event fires right before a new screenshot capture is taken. It can be used to customize the capture experience, for example by hiding certain GUI elements.


CaptureEnded

This event fires after a new screenshot capture completes. It can be used to restore any changes made when the CaptureBegan event fired.


UserCaptureSaved

This event fires when the user saves a screenshot using the Roblox screenshot capture UI. It can be used for analytics or to prompt the user to share their capture.

Parameters

captureContentId: ContentId

The contentId identifying the screenshot that the user saved.