捕捉服务 是一个客户端服务,可以让开发人员控制屏幕截图功能与其体验集成。它可以用于包含预设时刻,在用户进行屏幕截图时自动进行截图,用户可以然后保存、分享或删除截图。
概要
方法
截图并提供一个临时 contentId 来识别它。
提示用户将指定的捕获保存到他们的图库。
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
提示用户共享特定屏幕截文本捕捉。
活动
在捕获开始之前立即发射。
在捕获完成后发射。
用户保存捕文本捕捉时触发。
属性
方法
CaptureScreenshot
此方法为用户截图,但不会立即保存它在体验主菜单中的 截图 图库。相反,一个临时contentId 将创建,用于识别新的截文本捕捉。
onCaptureReady 回调可以用于提示用户保存或共享屏幕截图:
local CaptureService = game:GetService("CaptureService")
-- 脚本中包含此代验证码的父级图像标签
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
参数
一个调用式函数,其 contentId 的新捕捉准备好后。
返回
PromptSaveCapturesToGallery
此方法提示用户将根据提供的 contentIds 保存屏幕截图到其 捕获 图体验内的主菜单中的图片。
参数
ContentId 个串,用于识别要保存的屏幕截图。
一个调用函数,每 contentId 到一个指示用户是否接受保存那个捕文本捕捉的交易的字典映射。
返回
PromptShareCapture
此方法提示用户使用其设备上的原生共享页面使用 contentId 来识别屏幕截图。
捕获图像将与邀请链接共享体验,支持时。不所有设备/应用程序支持包括屏幕截图和邀请关联。
launchData 将在用户通过邀请关联接加入时提供在 launchData 字段中。
参数
ContentId 识别屏幕截图以分享。
可选的字符串,可以包含在邀请关联接中作为启动数据。
如果用户接受共享,则会调用可选的回调函数。
如果用户拒绝共享,则会调用一个可选的回调函数。
返回
活动
CaptureBegan
此事件在新的屏幕截图被拍摄之前触发。它可以用于自定义捕获体验,例如隐藏特定 GUI 元素。
UserCaptureSaved
当用户使用 Roblox 屏幕截图捕获 UI 保存屏幕截图时,该事件会触发。它可以用于分析或提示用户分享其文本捕捉。
参数
ContentID 用于识别用户保存的屏幕截图。