CaptureService

显示已弃用

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

无法创建
服务

捕捉服务 是一种客户端服务,可以让开发人员控制捕捉截图功能如何与他们的体验集成。它可以用来包含预设时刻,在那里用户的截图将自动保存、共分享或删除。

概要

方法

活动

属性

方法

CaptureScreenshot

()

该方法捕获用户的屏幕截图,但不会立即将其保存到体验主菜单中的 捕捉 库中。相反,临时的 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

默认值:""

返回

()

PromptSaveCapturesToGallery

()

该方法提示用户将通过提供的 contentIds 识别的屏幕截图保存到体验主菜单中的 捕捉库 图库。

参数

captures: Array
默认值:""
resultCallback: function

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

默认值:""

返回

()

PromptShareCapture

()

该方法提示用户分享由提供的 contentId 识别的屏幕截图,使用其设备上的本地分享表。

捕捉图像在支持时与体验的邀请链接共享。不是所有设备都支持包括屏幕截图和邀请关联。

launchData 将在邀请关联接通过加入的用户的 launchData 字段中可用。

为了避免在调用此方法时出错,请先调用 PolicyService:GetPolicyInfoForPlayerAsync() 并检查返回的字典中是否存在 IsContentSharingAllowed 真实。

参数

captureContent: Content
默认值:""
launchData: string

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

默认值:""
onAcceptedCallback: function

如果用户接受分享,可选回调函数会被调用。

默认值:""
onDeniedCallback: function

如果用户拒绝分享,可选回调函数会被调用。

默认值:""

返回

()

TakeCapture

()

参数

onCaptureReady: function
默认值:""
captureParams: Dictionary
默认值:"nil"

返回

()

活动

CaptureBegan

此事件在新截图捕捉之前发生,正是新截图捕捉的时候。它可以用于自定义捕获体验,例如通过隐藏某些图形用户界面元素。


CaptureEnded

此事件在新截图捕获完成后发生。它可以用来恢复 CaptureBegan 事件触发时所做的任何更改。


UserCaptureSaved

当用户使用 Roblox 截图捕捉 UI 保存截图时,此事件发生。它可以用于分析或提示用户分享捕文本捕捉。

参数

captureContentId: ContentId

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