截圖服務 是一個客戶端服務,讓開發人員可以控制屏幕截圖功能如何與其體驗集成。它可以用於包含預設時間,當發生截圖自動偵測到用戶,並且用戶可以儲存、分享或刪除截圖。
概要
方法
截圖並提供暫時 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 與指定的回報值指定一個Boolean指示用戶是否接受儲存那個捕擷取。
返回
PromptShareCapture
此方法提示使用者使用提供的 contentId 使用原生分享頁面在他們的設裝置上分享截圖。
捕捉圖像將會在支持時與嘗試邀請連結到體驗,如果您的設備/應用程式支持,您將會收到兩個邀請連結,分別是屏幕截圖和邀請連綁定。
launchData 將可用在 launchData 字段,對於通過邀請連綁定加入的用戶。
參數
ContentId 識別要分享的截圖。
可選的字串,可以在邀請綁定接中包含為啟動資料。
如果使用者接受分享,則會呼叫一個可選的回呼函數。
如果使用者拒絕分享,則會啟動一個可選的回來函數。
返回
活動
CaptureBegan
這個事件會在新的屏幕截圖被取得之前立即發生。它可以用來自訂截圖體驗,例如隱藏某些GUI元素。
UserCaptureSaved
當使用 Roblox 截圖佈建工具儲存截圖時發生此事件。它可以用於分析或提示使用者分享截擷取。
參數
ContentId 用於識別使用者儲存的截圖。