Lớp công cụ
CaptureService
*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.
Tóm Tắt
Phương Pháp
CaptureScreenshot(onCaptureReady: function):() |
CheckUploadCaptureStatusAsync(token: string):Tuple |
PromptCaptureGalleryPermissionAsync(captureGalleryPermission: Enum.CaptureGalleryPermission):boolean |
PromptSaveCapturesToGallery(captures: {any},resultCallback: function):() |
PromptShareCapture(captureContent: Content,launchData: string,onAcceptedCallback: function,onDeniedCallback: function):() |
ReadCapturesFromGalleryAsync(captureTypeFilters: {any},readFromAllEligibleExperiences: boolean):Tuple |
StartUploadCaptureAsync(capture: Capture):Tuple |
StartVideoCaptureAsync(onCaptureReady: function,captureParams: Dictionary):Enum.VideoCaptureStartedResult |
StopVideoCapture():() |
TakeScreenshotCaptureAsync(onCaptureReady: function,captureParams: Dictionary):() |
UploadCaptureAsync(capture: Capture):Tuple |
Sự Kiện
CaptureBegan(captureType: Enum.CaptureType):RBXScriptSignal |
CaptureEnded(captureType: Enum.CaptureType):RBXScriptSignal |
CaptureSaved(captureInfo: Dictionary):RBXScriptSignal |
UserCaptureSaved(captureContentId: ContentId):RBXScriptSignal |
Tài Liệu Tham Khảo API
Phương Pháp
CaptureScreenshot
CheckUploadCaptureStatusAsync
PromptCaptureGalleryPermissionAsync
CaptureService:PromptCaptureGalleryPermissionAsync(captureGalleryPermission:Enum.CaptureGalleryPermission):boolean
Tham Số
Lợi Nhuận
Mẫu mã
Yêu cầu quyền truy cập vào thư viện capture
local CaptureService = game:GetService("CaptureService")
local function isGalleryAccessGranted()
-- Yêu cầu quyền truy cập vào thư viện capture
local accepted = CaptureService:PromptCaptureGalleryPermissionAsync(Enum.CaptureGalleryPermission.ReadAndUpload)
return accepted
endPromptSaveCapturesToGallery
ReadCapturesFromGalleryAsync
Lợi Nhuận
Mẫu mã
Đọc các bản chụp từ thư viện và lặp qua các trang
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
-- Có thể là lỗi quyền, xem CaptureService:PromptCaptureGalleryPermissionAsync()
warn("Không thể lấy các captures ban đầu: " .. result.Name)
return
end
-- Lặp qua trang hiện tại
local currentPage = capturesPages:GetCurrentPage()
for _, capture in currentPage do
table.insert(allCaptures, capture)
end
-- Tiến tới trang tiếp theo cho đến khi hoàn tất
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
endStartUploadCaptureAsync
StartVideoCaptureAsync
CaptureService:StartVideoCaptureAsync(
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
StopVideoCapture
CaptureService:StopVideoCapture():()
Lợi Nhuận
()
TakeScreenshotCaptureAsync
Tham Số
| Giá Trị Mặc Định: "nil" |
Lợi Nhuận
()
UploadCaptureAsync
Tham Số
Lợi Nhuận
Mẫu mã
Tải lên bản chụp đến hệ thống tài sản
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
-- Xử lý lỗi
return nil
end
return assetId
end)
if not success then
-- Xử lý lỗi
return nil
end
return result
endSự Kiện
CaptureBegan
Tham Số
CaptureEnded
Tham Số
CaptureSaved
UserCaptureSaved
Tham Số
captureContentId:ContentId |