CaptureService
*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
キャプチャサービス は、開発者がスクリーンショットキャプチャ機能が自分のエクスペリエンスとどのように統合されるかを制御できるクライアント側サービスです。ユーザーが自動的にスクリーンショットを取得するプリセットの瞬間を含めることができ、そのユーザーはスクリーンショットを保存、共有、または削除できます。
概要
方法
スクリーンショットを取り、一時的な 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")
-- このコードを含むスクリプトの ImageLabel 親への参照
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
パラメータ
準備が整ったら、新しいキャプチャの contentId で呼ばれるコールバック関数。
戻り値
PromptSaveCapturesToGallery
このメソッドは、提供された contentIds によって識別されたスクリーンショットを、エクスペリエンスのメインメニュー内の キャプチャ ギャラリーに保存するようユーザーに促します。
パラメータ
ユーザーがキャプチャを保存することを承認したかどうかを示すブールンを指し示す辞書マッピングで呼び出されるコールバック関数。A callback function that will be invoked with a dictionary mapping each contentId.
戻り値
PromptShareCapture
このメソッドは、提供された contentId を使用してデバイス上のネイティブ共有シートで識別されたスクリーンショットをユーザーに共有するよう促します。
サポートされている場合、キャプチャ画像はエクスペリエンスへの招待リンクと共に共有されます。すべてのデバイスがスクリーンショットと招待リンクの両方をサポートするわけではありません。
The launchData は、招待リンクを介して参加するユーザーの launchData フィールドに表示されます。
このメソッドを呼び出すときにエラーを避けるには、まず PolicyService:GetPolicyInfoForPlayerAsync() を呼び出して、返された辞書で IsContentSharingAllowed が真になっているかどうかをチェックします。
パラメータ
招待リンクに招待データとして含めるオプションの文字列。
ユーザーが共有を承認した場合、オプションのコールバック関数が呼び出されます。
ユーザーが共有を拒否した場合、オプションのコールバック関数が呼び出されます。
戻り値
StopVideoCapture
戻り値
StartVideoCaptureAsync
パラメータ
戻り値
イベント
CaptureBegan
このイベントは、新しいスクリーンショットキャプチャが行われる直前に発動します。例えば、特定の GUI 要素を非表示にすることで、キャプチャエクスペリエンスをカスタマイズできます。
パラメータ
CaptureEnded
このイベントは、新しいスクリーンショットキャプチャが完了した後に発動します。CaptureBegan イベントが発動したときに行われた変更を復元するのに使用できます。
パラメータ
UserCaptureSaved
このイベントは、ユーザーが Roblox スクリーンショットキャプチャ UI を使用してスクリーンショットを保存すると発動します。分析に使用するか、ユーザーにキャプチャを共有するように促すことができます。
パラメータ
ユーザーが保存したスクリーンショットを識別する contentId