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ępniać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 przechwytywaćekranu.
Zdarzenia
Wybucha natychmiast przed rozpoczęciem pochwycenia.
Ogień po zakończeniu pochwycenia.
Wybucha, gdy użytkownik zapisuje przechwytywać.
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 przechwytywać.
Wezwanie onCaptureReady można użyć, aby poprosić użytkownika o zapisanie lub udostępnienie zrzut 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 przechwytywać.
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ądzenie.
Obraz zrzutu jest udostępniany wraz z linkiem zaproszenia do doświadczenia, gdy jest wspierany.Nie wszystkie urządzenia wspierają dodawanie zarówno łączyć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ą łączyć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 łączyćzaproszenia.
Opcjonalna funkcja powrotu wezwana, jeśli użytkownik akceptuje udostępnianie.
Opcjonalna funkcja powrotu wezwana, jeśli użytkownik odmawia udostępniania.
Zwroty
TakeCapture
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.
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.
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 przechwytywać.
Parametry
The contentId identyfikujący screenshot, który użytkownik zapisał.