CaptureService
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
キャプチャサービス は、開発者がスクリーンショットの撮影機能を体験と統合する方法を制御するクライアントサイドのサービスです。それを使用すると、ユーザーがスクリーンショットを自動的に取得し、そのユーザーがそのスクリーンショットを保シェア、共有、または削除できるプリセットの瞬間を含めることができます。
概要
方法
スクリーンショットを取得し、一時的な contentId を提供して識別します。
ユーザーに特定のキャプチャをギャラリに保存するよう促します。
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
特定のスクリーンショットを共有するようにユーザーテキストキャプチャ促します。
イベント
捕獲が開始する直前にファイアを開始します。
キャプチャーが完了した後にファイアを起動します。
ユーザーがキャプチテキストキャプチャを保存すると、ファイアを起動します。
プロパティ
方法
CaptureScreenshot
このメソッドは、ユーザーのためにスクリーンショットをキャプチャしますが、エクスペリエンスのメインメニューの キャプチャ ギャラリーに即座に保存されません。代わりに、一時的な contentId が作成され、新しいキャプチャを識別するためにメインメニューの Captures ギャラリーに保テキストキャプチャされます。
onCaptureReady コールバックを使用して、ユーザーにスクリーンショッスクショを保存または共有するように促すことができます：
local CaptureService = game:GetService("CaptureService")
-- このコードを含むスクリプトの親に参照する画像ラベル
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
パラメータ
新しいキャプチャーの準備ができたら、contentId の呼び出し機能を呼び出すコールバック関数。
戻り値
PromptSaveCapturesToGallery
このメソッドは、contentIds を含む提供された 画面ショット をエクスペリエンスのメインメニューの キャプチャ ギャラリに保存するようにユーザーに求めます。
パラメータ
Content-ID 文字列で、保存するスクリーンショットを識別する配列。
ユーザーがそのキャプチャーを受信したかどうかを示すボランティアの機能。ContentId にマップされたダイクトリを持つコールバック関数。
戻り値
PromptShareCapture
このメソッドは、ContentId を使用して、デバイスのネイティブな共有シートを使用して識別されたスクリーンショットをユーザーに共有するように促します。
キャプチャ画像は、サポートされると、エクスペリエンスへの招待リンクと共有されます。すべてのデバイス/アプリがスクリーンショットと招待リン紐づけるの両方をサポートしているわけではありません。
ユーザーが招待リンクを通じて参加するユーザーには、launchData が launchData フィールドにあります。
パラメータ
Content-ID スクリーンショットを共有する画面を識シェアします。
招待リンクに含めるオプションの文字列。
ユーザーが共有を受け入れた場合、オプションのコールバック関数を呼び出します。
ユーザーが共有を拒否すると、オプションのコールバック関数が呼び出されます。
戻り値
イベント
CaptureBegan
このイベントは、新しいスクリーンショットの撮影が取られる直前に発動します。これを使用すると、キャプチャーエクスペリエンスをカスタマイズできます。たとえば、特定の GUI 要素を非表示にするなどです。
UserCaptureSaved
このイベントは、Roblox スクリーンショットキャプチャ UI を使用してスクリーンショットを保存するときに発動します。これは分析やユーザーにスクリーンショッテキストキャプチャを共有するように促すために使用されます。
パラメータ
ユーザーが保存したスクリーンショットを識別する contentId。