CaptureService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
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
Macht einen Screenshot und bietet eine temporäre contentId an, um es zu identifizieren.
Fordert den Benutzer auf, bestimmte Aufnahmen in seine Galerie zu speichern.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Fordert den Benutzer auf, einen bestimmten Screenshot-Capture zu teilen.
- StartVideoCaptureAsync(onCaptureReady : function,captureParams : Dictionary):Enum.VideoCaptureStartedResult
Ereignisse
Feuert sofort bevor ein Angriff beginnt.
Feuert nach Beendigung einer Einnahme ab.
Feuert, wenn der Benutzer eine Capture speichert.
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
Eine Rückruffunktion, die mit dem contentId der neuen Aufnahme aufgerufen wird, sobald sie bereit ist.
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
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.
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
Eine optionale Zeichenkette, die als Startdaten im Einladungslink enthalten sein soll.
Eine optionale Rückruffunktion, die aufgerufen wird, wenn der Benutzer das Teilen akzeptiert.
Eine optionale Rückruffunktion, die aufgerufen wird, wenn der Benutzer das Teilen ablehnt.
Rückgaben
StopVideoCapture
Rückgaben
TakeCapture
Parameter
Rückgaben
StartVideoCaptureAsync
Parameter
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.
Parameter
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.
Parameter
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
Die contentId Identifizierung des Screenshots, den der Benutzer gespeichert hat.