CaptureService

顯示已棄用項目

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

無法建立
服務

截圖服務 是一個客戶端服務,讓開發人員可以控制屏幕截圖功能如何與其體驗集成。它可以用於包含預設時間,當發生截圖自動偵測到用戶,並且用戶可以儲存、分享或刪除截圖。

概要

方法

活動

屬性

方法

CaptureScreenshot

void

此方法會為用戶截圖,但不會立即儲存在體驗主選單中的 捕捉 галере。相反,暫時的 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 ,該函數會在新捕捉準備好後呼叫。


返回

void

PromptSaveCapturesToGallery

void

此方法要求用戶將由提供的 contentIds 中識別的屏幕截圖儲存到體驗主選單中的 帶畫眉 圖冊中。

參數

contentIds: Array

一個 contentId 列,用於儲存截圖。

resultCallback: function

一個回調函數,會在每個 contentId 與指定的回報值指定一個Boolean指示用戶是否接受儲存那個捕擷取。


返回

void

PromptShareCapture

void

此方法提示使用者使用提供的 contentId 使用原生分享頁面在他們的設裝置上分享截圖。

捕捉圖像將會在支持時與嘗試邀請連結到體驗,如果您的設備/應用程式支持,您將會收到兩個邀請連結,分別是屏幕截圖和邀請連綁定。

launchData 將可用在 launchData 字段,對於通過邀請連綁定加入的用戶。

參數

contentId: ContentId

ContentId 識別要分享的截圖。

launchData: string

可選的字串,可以在邀請綁定接中包含為啟動資料。

onAcceptedCallback: function

如果使用者接受分享,則會呼叫一個可選的回呼函數。

onDeniedCallback: function

如果使用者拒絕分享,則會啟動一個可選的回來函數。


返回

void

活動

CaptureBegan

這個事件會在新的屏幕截圖被取得之前立即發生。它可以用來自訂截圖體驗,例如隱藏某些GUI元素。


CaptureEnded

這個事件會在新的截圖捕捉完成後發生。它可以用來恢復 CaptureBegan 事件發出的任何變更。


UserCaptureSaved

當使用 Roblox 截圖佈建工具儲存截圖時發生此事件。它可以用於分析或提示使用者分享截擷取。

參數

captureContentId: ContentId

ContentId 用於識別使用者儲存的截圖。