CaptureService

Veraltete anzeigen

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Nicht erstellbar
Dienst

CaptureService ist ein Client-seitiger Dienst, der es Entwicklern ermöglicht, zu kontrollieren, wie die Screenshot-Capture-Funktion mit ihren Erlebnissen integriert wird.Es kann verwendet werden, um voreingestellte Momente einzuschließen, in denen ein Screenshot automatisch für einen Benutzer aufgenommen wird, und dieser Benutzer kann dann den Screenshot speichern, teilen oder löschen.

Zusammenfassung

Methoden

Ereignisse

Eigenschaften

Methoden

CaptureScreenshot

()

Diese Methode erstellt einen Screenshot für den Benutzer, speichert ihn jedoch nicht sofort in ihrer Einfanggalerie innerhalb des Hauptmenüs des Erlebnisses.Stattdessen wird ein temporäres contentId erstellt, um die neue Aufnahme zu identifizieren.

Der onCaptureReady Rückruf kann verwendet werden, um den Benutzer aufzufordern, den Screenshot zu speichern oder zu teilen:


local CaptureService = game:GetService("CaptureService")
-- Verweis auf ein ImageLabel-Elternteil des Skripts, das diesen Code enthält
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)

Parameter

onCaptureReady: function

Eine Rückruffunktion, die mit dem contentId der neuen Aufnahme aufgerufen wird, sobald sie bereit ist.

Standardwert: ""

Rückgaben

()

PromptSaveCapturesToGallery

()

Diese Methode fordert den Benutzer auf, die identifizierten Screenshots, die durch die angegebene contentIds bereitgestellt wurden, in ihre Captures Galerie innerhalb des Hauptmenüs des Erlebnisses zu speichern.

Parameter

captures: Array
Standardwert: ""
resultCallback: function

Eine Rückruffunktion, die mit einer Diktion aufgerufen wird, die jede contentId an einen booligen übermittelt, der angibt, ob der Benutzer die Aufnahme speichern akzeptiert hat.

Standardwert: ""

Rückgaben

()

PromptShareCapture

()

Diese Methode fordert den Benutzer auf, den Screenshot, der durch die bereitgestellte contentId mithilfe des native Shared Sheets auf seinem Gerät identifiziert wurde, zu teilen.

Das Aufnahmebild wird zusammen mit einem Einladungslink zur Erfahrung geteilt, wenn es unterstützt wird.Nicht alle Geräte unterstützen beides, einen Screenshot und einen Einladungslink.

Die launchData wird im Feld launchData für Benutzer verfügbar sein, die sich über den Einladungslink anmelden.

Um einen Fehler zu vermeiden, wenn diese Methode aufgerufen wird, rufen Sie zuerst PolicyService:GetPolicyInfoForPlayerAsync() an und überprüfen Sie, ob IsContentSharingAllowed in der zurückgegebenen Diktion wahr ist.

Parameter

captureContent: Content
Standardwert: ""
launchData: string

Eine optionale Zeichenkette, die als Startdaten im Einladungslink enthalten sein soll.

Standardwert: ""
onAcceptedCallback: function

Eine optionale Rückruffunktion, die aufgerufen wird, wenn der Benutzer das Teilen akzeptiert.

Standardwert: ""
onDeniedCallback: function

Eine optionale Rückruffunktion, die aufgerufen wird, wenn der Benutzer das Teilen ablehnt.

Standardwert: ""

Rückgaben

()

StopVideoCapture

()

Rückgaben

()

TakeCapture

()

Parameter

onCaptureReady: function
Standardwert: ""
captureParams: Dictionary
Standardwert: "nil"

Rückgaben

()

StartVideoCaptureAsync

Angehalten

Parameter

onCaptureReady: function
Standardwert: ""
captureParams: Dictionary
Standardwert: "nil"

Rückgaben

Ereignisse

CaptureBegan

Dieses Ereignis wird ausgelöst, kurz bevor ein neuer Screenshot aufgenommen wird.Es kann verwendet werden, um das Aufnahme-Erlebnis anzupassen, zum Beispiel, indem bestimmte GUI-Elemente ausgeblendet werden.


CaptureEnded

Dieses Ereignis wird ausgelöst, nachdem ein neuer Screenshot-Einschuss abgeschlossen ist. Es kann verwendet werden, um alle Änderungen wiederherzustellen, die beim Auslösen des Ereignisses CaptureBegan vorgenommen wurden.


UserCaptureSaved

Dieses Ereignis wird ausgelöst, wenn der Benutzer einen Screenshot mit der Roblox-Screenshot-Aufnahme-UI speichert.Es kann für Analysen verwendet werden oder um den Benutzer aufzufordern, seine Aufnahme zu teilen.

Parameter

captureContentId: ContentId

Die contentId Identifizierung des Screenshots, den der Benutzer gespeichert hat.