CaptureService

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

无法创建
服务

捕捉服务 是一个客户端服务,可以让开发人员控制屏幕截图功能与其体验集成。它可以用于包含预设时刻,在用户进行屏幕截图时自动进行截图,用户可以然后保存、分享或删除截图。

概要

方法

活动

属性

方法

CaptureScreenshot

void

此方法为用户截图,但不会立即保存它在体验主菜单中的 截图 图库。相反,一个临时contentId 将创建,用于识别新的截文本捕捉。

onCaptureReady 回调可以用于提示用户保存或共享屏幕截图:


local CaptureService = game:GetService("CaptureService")
-- 脚本中包含此代验证码的父级图像标签
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)

参数

onCaptureReady: function

一个调用式函数,其 contentId 的新捕捉准备好后。


返回

void

PromptSaveCapturesToGallery

void

此方法提示用户将根据提供的 contentIds 保存屏幕截图到其 捕获 图体验内的主菜单中的图片。

参数

contentIds: Array

ContentId 个串,用于识别要保存的屏幕截图。

resultCallback: function

一个调用函数,每 contentId 到一个指示用户是否接受保存那个捕文本捕捉的交易的字典映射。


返回

void

PromptShareCapture

void

此方法提示用户使用其设备上的原生共享页面使用 contentId 来识别屏幕截图。

捕获图像将与邀请链接共享体验,支持时。不所有设备/应用程序支持包括屏幕截图和邀请关联。

launchData 将在用户通过邀请关联接加入时提供在 launchData 字段中。

参数

contentId: ContentId

ContentId 识别屏幕截图以分享。

launchData: string

可选的字符串,可以包含在邀请关联接中作为启动数据。

onAcceptedCallback: function

如果用户接受共享,则会调用可选的回调函数。

onDeniedCallback: function

如果用户拒绝共享,则会调用一个可选的回调函数。


返回

void

活动

CaptureBegan

此事件在新的屏幕截图被拍摄之前触发。它可以用于自定义捕获体验,例如隐藏特定 GUI 元素。


CaptureEnded

这个事件发生在新的屏幕截图完成后。它可以用于恢复在 CaptureBegan 事件发生时所做的任何更改。


UserCaptureSaved

当用户使用 Roblox 屏幕截图捕获 UI 保存屏幕截图时,该事件会触发。它可以用于分析或提示用户分享其文本捕捉。

参数

captureContentId: ContentId

ContentID 用于识别用户保存的屏幕截图。