CaptureService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
CaptureService ist ein clientseitiges Service, das es den Entwicklern ermöglicht, die Screenshot-Erfassungsfunktion mit ihren Erlebnissen zu steuern. Es kann verwendet werden, um vordefinierte Momente zu enthalten, in denen ein Screenshot automatisch für einen Benutzer aufgenommen wird, und dieser Benutzer dann speichern, teilen oder löschen kann.
Zusammenfassung
Methoden
Macht einen Screenshot und bietet einen temporären contentId an, um ihn zu identifizieren.
Fordert den Benutzer auf, bestimmte Captures in seine Galerie zu speichern.
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
Fordert den Benutzer auf, einen bestimmten Screenshot zu teilen.
Ereignisse
Feuert sofort vor dem Beginn einer Käptur ab.
Feuert nach dem Beenden eines Captures ab.
Feuert, wenn der Benutzer einen erfassenspeichert.
Eigenschaften
Methoden
CaptureScreenshot
Diese Methode erstellt einen Screenshot für den Benutzer, speichert ihn jedoch nicht sofort in der Captures-Galerie innerhalb des Hauptmenüs des Erlebnisses. Stattdessen wird ein temporärer contentId erstellt, um die neue erfassenzu identifizieren.
Der onCaptureReady-Callback kann verwendet werden, um den Benutzer aufzufordern, den Screenshot zu speichern oder zu teilen:
local CaptureService = game:GetService("CaptureService")
-- Verweis auf einen Bildernamen-Elternteil des Skripts, der diesen Codesenthält
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parameter
Eine Rückruck-Funktion, die mit dem contentId der neuen Capture bereit ist.
Rückgaben
PromptSaveCapturesToGallery
Diese Methode fordert den Benutzer auf, die durch den angegebenen contentIds identifizierten Screenshots in seine Captures-Galerie innerhalb des Hauptmenüs des Erlebnisses zu speichern.
Parameter
Ein Array von contentId Strings, die die Screenshots speichern.
Eine Rückruf-Funktion, die mit einer Dictionaries-Map jeden contentId mit einemBoolean anzeigt, ob der Benutzer die erfassengespeichert hat, die angeboten wird.
Rückgaben
PromptShareCapture
Diese Methode bittet den Benutzer, den identifizierten Screenshot mit dem contentId verwenden, der in seinem Gerät integriert ist.
Das Einstellungsbild wird zusammen mit einem Einladungslink zur Erfahrung geteilt, wenn er unterstützt wird. Nicht alle Geräte/Apps unterstützen sowohl einen Screenshot als auch einen verlinken.
Die launchData wird für Benutzer verfügbar sein, die durch den verlinkenbeitreten.
Parameter
Die contentId mit dem Screenshot, den Sie teilen möchten.
Eine optionale Zeichenfolge, die als Startdaten im verlinkenenthalten sein soll.
Eine optionale Rückruf-Funktion wird aufgerufen, wenn der Benutzer die Freigabe anbtreten.
Eine optionale Rückruffunktion wird aufgerufen, wenn der Benutzer die Freigabe ablehnt.
Rückgaben
Ereignisse
CaptureBegan
Dieses Ereignis wird ausgelöst, kurz vor der Aufnahme eines neuen Screenshots. Es kann verwendet werden, um das Erlebnis zu personalisieren, z. B. indem bestimmte GUI-Elemente versteckt werden.
CaptureEnded
Dieses Ereignis wird ausgelöst, nachdem ein neuer Screenshot-Capturing abgeschlossen ist. Es kann verwendet werden, um alle Änderungen rückgängig zu machen, die getätigt wurden, wenn das CaptureBegan-Ereignis abgeschlossen ist.
UserCaptureSaved
Dieses Ereignis wird ausgelöst, wenn der Benutzer einen Screenshot mit der Roblox-Screenshot-Capturing-UI speichert. Es kann für Analysen verwendet werden oder den Benutzer auffordern, seinen erfassenzu teilen.
Parameter
Die contentId identifiziert den Screenshot, den der Benutzer gespeichert hat.