捕捉服務 是一種客戶端服務,允許開發人員控制截圖捕捉功能如何與他們的體驗整合。它可以用來包含預設時刻,當使用者截圖時,系統會自動儲存、分享或刪除該截圖。
概要
方法
截圖並提供暫時的 contentId 來識別它。
提示使用者將指定捕捉記錄儲存到相簿中。
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
提示使用者分享指定的截圖捕捉。
- StartVideoCaptureAsync(onCaptureReady : function,captureParams : Dictionary):Enum.VideoCaptureStartedResult
活動
在捕捉開始之前立即發生火災。
在捕捉結束後發生火焰。
當使用者儲存捕捉時發生火災。
屬性
方法
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 映射到一個字典來指示用戶是否接受保存那個捕捉。
返回
PromptShareCapture
這個方法提示用戶使用提供的 contentId 分享他們裝置上標示的截圖。
當支持時,捕捉圖像會與體驗的邀請鏈接一起共享。不是所有裝置都支持包括截圖和邀請鏈接。
launchData 將在通過邀請鏈接加入的用戶的 launchData 字段中提供。
若要避免在呼叫此方法時發生錯誤,請先呼叫 PolicyService:GetPolicyInfoForPlayerAsync() 並檢查返回的字典中是否存在 IsContentSharingAllowed 真實。
參數
可選擇包含在邀請鏈接中的啟動資料的字串。
如果使用者接受分享,可選擇的回呼功能會被呼叫。
如果使用者拒絕分享,可選擇的回呼功能會被呼叫。
返回
StopVideoCapture
返回
StartVideoCaptureAsync
參數
返回
活動
UserCaptureSaved
當使用者使用 Roblox 截圖捕捉介面儲存截圖時,此事件發生。它可用於分析或提示用戶分享他們的捕捉。
參數
用於識別用戶保存的截圖的 contentId 。