Informacje o wersji
Edukacja
Klasa silnika
CaptureService
Brak możliwości tworzenia
Usługa

*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.


Podsumowanie
Metody
CaptureScreenshot(onCaptureReady: function):()
PromptSaveCapturesToGallery(captures: {any},resultCallback: function):()
PromptShareCapture(captureContent: Content,launchData: string,onAcceptedCallback: function,onDeniedCallback: function):()
ReadCapturesFromGalleryAsync(captureTypeFilters: {any},readFromAllEligibleExperiences: boolean):Tuple
TakeScreenshotCaptureAsync(onCaptureReady: function,captureParams: Dictionary):()
Członkowie odziedziczeni

Materiały referencyjne dotyczące interfejsów API
Metody
CaptureScreenshot
Możliwości: Capture
CaptureService:CaptureScreenshot(onCaptureReady:function):()
Parametry
onCaptureReady:function
Zwroty
()

CheckUploadCaptureStatusAsync
Wynik
Możliwości: Capture
CaptureService:CheckUploadCaptureStatusAsync(token:string):Tuple
Parametry
token:string
Zwroty

PromptCaptureGalleryPermissionAsync
Wynik
Możliwości: Capture
CaptureService:PromptCaptureGalleryPermissionAsync(captureGalleryPermission:Enum.CaptureGalleryPermission):boolean
Parametry
captureGalleryPermission:Enum.CaptureGalleryPermission
Zwroty
Przykłady kodu
Prośba o zgodę na dostęp do galerii zrzutów
local CaptureService = game:GetService("CaptureService")
local function isGalleryAccessGranted()
-- Proszę o zgodę na dostęp do galerii zrzutów
local accepted = CaptureService:PromptCaptureGalleryPermissionAsync(Enum.CaptureGalleryPermission.ReadAndUpload)
return accepted
end

PromptSaveCapturesToGallery
Możliwości: Capture
CaptureService:PromptSaveCapturesToGallery(
captures:{any}, resultCallback:function
):()
Parametry
captures:{any}
resultCallback:function
Zwroty
()

PromptShareCapture
Możliwości: Capture
CaptureService:PromptShareCapture(
captureContent:Content, launchData:string, onAcceptedCallback:function, onDeniedCallback:function
):()
Parametry
captureContent:Content
launchData:string
onAcceptedCallback:function
onDeniedCallback:function
Zwroty
()

ReadCapturesFromGalleryAsync
Wynik
Możliwości: Capture
CaptureService:ReadCapturesFromGalleryAsync(
captureTypeFilters:{any}, readFromAllEligibleExperiences:boolean
Parametry
captureTypeFilters:{any}
Wartość domyślna: "{}"
readFromAllEligibleExperiences:boolean
Wartość domyślna: false
Zwroty
Przykłady kodu
Odczytaj zbiory z galerii i przejdź przez strony
local CaptureService = game:GetService("CaptureService")
local function readCapturesFromGallery()
local allCaptures = {}
local capturesPages
local success, result = pcall(function()
local readResult, pages = CaptureService:ReadCapturesFromGalleryAsync({}, false)
if readResult == Enum.ReadCapturesFromGalleryResult.Success then
capturesPages = pages
end
return readResult
end)
if not success or result ~= Enum.ReadCapturesFromGalleryResult.Success then
-- Prawdopodobnie błąd uprawnień, zobacz CaptureService:PromptCaptureGalleryPermissionAsync()
warn("Nie udało się pobrać początkowych zrzutów: " .. result.Name)
return
end
-- Iteruj przez bieżącą stronę
local currentPage = capturesPages:GetCurrentPage()
for _, capture in currentPage do
table.insert(allCaptures, capture)
end
-- Przejdź do następnej strony aż do zakończenia
while not capturesPages.IsFinished do
local advanceToNextPageSuccess, _ = pcall(function()
capturesPages:AdvanceToNextPageAsync()
end)
if not advanceToNextPageSuccess then
return
end
currentPage = capturesPages:GetCurrentPage()
for _, capture in currentPage do
table.insert(allCaptures, capture)
end
end
return allCaptures
end

StartUploadCaptureAsync
Wynik
Możliwości: Capture
CaptureService:StartUploadCaptureAsync(capture:Capture):Tuple
Parametry
capture:Capture
Zwroty

StartVideoCaptureAsync
Wynik
Możliwości: Capture
CaptureService:StartVideoCaptureAsync(
onCaptureReady:function, captureParams:Dictionary
Parametry
onCaptureReady:function
captureParams:Dictionary
Wartość domyślna: "nil"

StopVideoCapture
Możliwości: Capture
CaptureService:StopVideoCapture():()
Zwroty
()

TakeScreenshotCaptureAsync
Możliwości: Capture
CaptureService:TakeScreenshotCaptureAsync(
onCaptureReady:function, captureParams:Dictionary
):()
Parametry
onCaptureReady:function
captureParams:Dictionary
Wartość domyślna: "nil"
Zwroty
()

UploadCaptureAsync
Wynik
Możliwości: Capture
CaptureService:UploadCaptureAsync(capture:Capture):Tuple
Parametry
capture:Capture
Zwroty
Przykłady kodu
Prześlij zrzut do systemu zasobów
local CaptureService = game:GetService("CaptureService")
local function uploadCapture(capture: Capture)
local success, result = pcall(function()
local uploadCaptureResult, assetId = CaptureService:UploadCaptureAsync(capture)
if uploadCaptureResult ~= Enum.UploadCaptureResult.Success then
-- Obsłuż błąd
return nil
end
return assetId
end)
if not success then
-- Obsłuż błąd
return nil
end
return result
end

Zdarzenia
CaptureBegan
Możliwości: Capture
CaptureService.CaptureBegan(captureType:Enum.CaptureType):RBXScriptSignal
Parametry
captureType:Enum.CaptureType

CaptureEnded
Możliwości: Capture
CaptureService.CaptureEnded(captureType:Enum.CaptureType):RBXScriptSignal
Parametry
captureType:Enum.CaptureType

CaptureSaved
Przestarzałe

UserCaptureSaved
Możliwości: Capture
CaptureService.UserCaptureSaved(captureContentId:ContentId):RBXScriptSignal
Parametry
captureContentId:ContentId

©2026 Roblox Corporation. Nazwa Roblox, logo Roblox oraz hasło „Powering Imagination” należą do naszych zarejestrowanych i niezarejestrowanych znaków towarowych na terenie Stanów Zjednoczonych oraz w innych krajach.