CaptureService
*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.
Usługa CaptureService jest usługą po stronie klienta, która pozwala programistom kontrolować, w jaki sposób funkcja przechwytywania obrazów ekranowych integruje się z ich doświadczeniami.Można go używać, aby uwzględnić momenty ustawione wcześniej, w których zostanie wykonany automatyczny zrzut ekranu dla użytkownika, a ten użytkownik może następnie zapisać, udostępnić lub usunąć zrzut ekranu.
Podsumowanie
Metody
Robi zrzut ekranu i dostarcza tymczasowe contentId do jego zidentyfikowania.
Wymaga od użytkownika zapisania określonych zdjęć do jego galerii.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Poprosić użytkownika o udostępnienie zarejestrowanego obrazu ekranu.
- StartVideoCaptureAsync(onCaptureReady : function,captureParams : Dictionary):Enum.VideoCaptureStartedResult
Zdarzenia
Wybucha natychmiast przed rozpoczęciem pochwycenia.
Ogień po zakończeniu pochwycenia.
Wybucha, gdy użytkownik zapisuje zdjęcie.
Właściwości
Metody
CaptureScreenshot
Ta metoda rejestruje zrzut ekranu dla użytkownika, ale nie natychmiast zapisuje go w galerii Przechwyty w głównym menu doświadczenia.Zamiast tego tworzy się tymczasowe contentId tymczasowe, aby zidentyfikować nowe zatrzymanie.
Wezwanie onCaptureReady można użyć, aby poprosić użytkownika o zapisanie lub udostępnienie obrazu ekranu:
local CaptureService = game:GetService("CaptureService")
-- Odwołanie do rodzica etykiety obrazu zawierającego ten kod w skrypcie
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parametry
Funkcja powrotna, która jest wywoływana za pomocą contentId nowego zapisu, gdy jest gotowa.
Zwroty
PromptSaveCapturesToGallery
Ta metoda wymaga od użytkownika zapisanie zrzutów ekranu zidentyfikowanych przez podane contentIds w galerii Zdjęć w menu głównym doświadczenia.
Parametry
Funkcja powrotna, która zostanie wywołana za pomocą mapy słownika każdego contentId do prawdziwego binarnego wskazującego, czy użytkownik zaakceptował zapisanie tego złapania.
Zwroty
PromptShareCapture
Ta metoda wymaga od użytkownika podzielenia zrzutu ekranu zidentyfikowanego za pomocą dostarczonego contentId używając natywnej karty udostępniania na jego urządzeniu.
Obraz zrzutu jest udostępniany wraz z linkiem zaproszenia do doświadczenia, gdy jest wspierany.Nie wszystkie urządzenia wspierają dodawanie zarówno linku do zrzutu ekranu, jak i zaproszenia.
Funkcja launchData będzie dostępna w polu launchData dla użytkowników, którzy dołączają za pomocą linku zaproszenia.
Aby uniknąć błędu podczas wywołania tej metody, najpierw wezwij PolicyService:GetPolicyInfoForPlayerAsync() i sprawdź, czy IsContentSharingAllowed jest prawdą w zwroconym słowniku.
Parametry
Opcjonalna struna do uwzględnienia jako dane o uruchomieniu w linku zaproszenia.
Opcjonalna funkcja powrotu wezwana, jeśli użytkownik akceptuje udostępnianie.
Opcjonalna funkcja powrotu wezwana, jeśli użytkownik odmawia udostępniania.
Zwroty
StopVideoCapture
Zwroty
TakeCapture
Parametry
Zwroty
StartVideoCaptureAsync
Parametry
Zwroty
Zdarzenia
CaptureBegan
To wydarzenie wystrzeliwuje tuż przed wykonaniem nowego zrzutu ekranu.Można go używać do dostosowywania doświadczenia z rejestrowaniem, na przykład przez ukrywanie pewnych elementów interfejsu użytkownika.
Parametry
CaptureEnded
To wydarzenie wystrzeliwuje po zakończeniu nowego zrzutu ekranu. Można go użyć do przywrócenia wszelkich zmian dokonanych po uruchomieniu wydarzenia CaptureBegan.
Parametry
UserCaptureSaved
To wydarzenie wystrzeliwuje się, gdy użytkownik zapisuje zrzut ekranu za pomocą interfejsu użytkownika do przechwytywania zrzutów ekranu Roblox.Można go używać do analiz lub żeby poprosić użytkownika o podzielenie się jego zdjęciem.
Parametry
The contentId identyfikujący screenshot, który użytkownik zapisał.