CaptureService

顯示已棄用項目

*此內容是使用 AI(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 映射到一個字典來指示用戶是否接受保存那個捕捉。

預設值:""

返回

()

PromptShareCapture

()

這個方法提示用戶使用提供的 contentId 分享他們裝置上標示的截圖。

當支持時,捕捉圖像會與體驗的邀請鏈接一起共享。不是所有裝置都支持包括截圖和邀請鏈接。

launchData 將在通過邀請鏈接加入的用戶的 launchData 字段中提供。

若要避免在呼叫此方法時發生錯誤,請先呼叫 PolicyService:GetPolicyInfoForPlayerAsync() 並檢查返回的字典中是否存在 IsContentSharingAllowed 真實。

參數

captureContent: Content
預設值:""
launchData: string

可選擇包含在邀請鏈接中的啟動資料的字串。

預設值:""
onAcceptedCallback: function

如果使用者接受分享,可選擇的回呼功能會被呼叫。

預設值:""
onDeniedCallback: function

如果使用者拒絕分享,可選擇的回呼功能會被呼叫。

預設值:""

返回

()

StopVideoCapture

()

返回

()

TakeCapture

()

參數

onCaptureReady: function
預設值:""
captureParams: Dictionary
預設值:"nil"

返回

()

StartVideoCaptureAsync

暫停

參數

onCaptureReady: function
預設值:""
captureParams: Dictionary
預設值:"nil"

返回

活動

CaptureBegan

此事件在新截圖捕捉之前發生,正是捕捉新截圖的時候。它可以用來自訂捕捉體驗,例如隱藏特定的使用者介面元素。

參數

captureType: Enum.CaptureType

CaptureEnded

此事件在新截圖捕捉完成後發生。它可以用來恢復發射 CaptureBegan 事件時所做的任何變更。

參數

captureType: Enum.CaptureType

UserCaptureSaved

當使用者使用 Roblox 截圖捕捉介面儲存截圖時,此事件發生。它可用於分析或提示用戶分享他們的捕捉。

參數

captureContentId: ContentId

用於識別用戶保存的截圖的 contentId