捕捉服务 是一种客户端服务,可以让开发人员控制捕捉截图功能如何与他们的体验集成。它可以用来包含预设时刻,在那里用户的截图将自动保存、共分享或删除。
概要
方法
截取屏幕截图并提供临时 contentId 来识别它。
提示用户将指定捕捉保存到他们的图库。
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
提示用户共享指定的截图捕文本捕捉。
活动
在捕获开始之前立即发生火灾。
捕获完成后发生的火焰。
当用户保存捕文本捕捉时发生火灾。
属性
方法
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 到一个 bool 指示用户是否接受了保存那个捕文本捕捉。
返回
PromptShareCapture
该方法提示用户分享由提供的 contentId 识别的屏幕截图,使用其设备上的本地分享表。
捕捉图像在支持时与体验的邀请链接共享。不是所有设备都支持包括屏幕截图和邀请关联。
launchData 将在邀请关联接通过加入的用户的 launchData 字段中可用。
为了避免在调用此方法时出错,请先调用 PolicyService:GetPolicyInfoForPlayerAsync() 并检查返回的字典中是否存在 IsContentSharingAllowed 真实。
参数
可选的字符串,可包含在邀请关联接中的启动数据。
如果用户接受分享,可选回调函数会被调用。
如果用户拒绝分享,可选回调函数会被调用。
返回
活动
CaptureBegan
此事件在新截图捕捉之前发生,正是新截图捕捉的时候。它可以用于自定义捕获体验,例如通过隐藏某些图形用户界面元素。
UserCaptureSaved
当用户使用 Roblox 截图捕捉 UI 保存截图时,此事件发生。它可以用于分析或提示用户分享捕文本捕捉。
参数
用于识别用户保存的屏幕截图的 contentId 。