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.
Dịch vụ thu nhập là một dịch vụ bên khách cho phép các nhà phát triển kiểm soát cách tính năng thu nhập hình ảnh tích hợp với kinh nghiệm của họ.Nó có thể được sử dụng để bao gồm các khoảnh khắc được đặt trước mà một bức xúc được lấy tự động cho một người dùng, và người dùng đó sau đó có thể lưu, chia sẻ hoặc xóa ảnh chụp màn hình.
Tóm Tắt
Phương Pháp
Chụp một bức ảnh và cung cấp một tạm thời contentId để xác định nó.
Yêu cầu người dùng lưu các bức ảnh được chỉ định vào bộ sưu tập của họ.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Yêu cầu người dùng chia sẻ một bản lưu chiếm lấychụp màn hình được xác định.
Sự Kiện
Bắt lửa ngay lập tức trước khi một cuộc chiếm bắt bắt đầu.
Lửa bùng phát sau khi một lần bắt kết thúc.
Bắt lửa khi người dùng lưu lại một lượt chiếm lấy.
Thuộc Tính
Phương Pháp
CaptureScreenshot
Phương pháp này nhận bức ảnh chụp màn hình cho người dùng nhưng không lưu ngay lập tức vào thư viện Lưu của họ trong menu chính của trải nghiệm.Thay vào đó, một tạm thời contentId được tạo ra để xác định bắt chiếm lấymới.
Cuộc gọi trả lại onCaptureReady có thể được sử dụng để yêu cầu người dùng lưu hoặc chia ảnh chụp màn hình:
local CaptureService = game:GetService("CaptureService")
-- Tham chiếu đến một ImageLabel cha của kịch bản chứa mã này
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Tham Số
Một chức năng trả lời gọi được gọi với contentId của bắt giữ mới một khi nó đã sẵn sàng.
Lợi Nhuận
PromptSaveCapturesToGallery
Phương pháp này yêu cầu người dùng lưu các bức ảnh màn hình được xác định bởi contentIds được cung cấp vào bộ sưu tập Chụp của họ trong menu chính của trải nghiệm.
Tham Số
Một chức năng trả lời gọi sẽ được kích hoạt với một bản định danh từ điển mỗi contentId đến một boolean chỉ ra nếu người dùng đã chấp nhận lưu lại những gì chiếm lấyđược.
Lợi Nhuận
PromptShareCapture
Phương pháp này yêu cầu người dùng chia sẻ bức xúc được xác định bởi ảnh chụp màn hình cung cấp contentId bằng cách sử dụng trang chia sẻ bản địa trên thiết bị của họ.
Hình ảnh bắt lượt được chia sẻ cùng với liên kết mời đến trải nghiệm khi được hỗ trợ.Không phải tất cả các thiết bị đều hỗ trợ bao gồm cả một liên kết bản in và một liên kết mời.
Các launchData sẽ có sẵn trong trường launchData cho người dùng tham gia qua liên kết mời.
Để tránh một lỗi khi gọi phương thức này, hãy gọi PolicyService:GetPolicyInfoForPlayerAsync() trước tiên và kiểm tra xem IsContentSharingAllowed có đúng trong từ điển trả về hay không.
Tham Số
Một chuỗi tùy chọn để bao gồm dữ liệu khởi động trong liên kết mời.
Một chức năng trả lời bắt buộc tùy chọn được gọi nếu người dùng chấp nhận chia sẻ.
Một chức năng trả lời bắt buộc tùy chọn được gọi nếu người dùng từ chối chia sẻ.
Lợi Nhuận
TakeCapture
Tham Số
Lợi Nhuận
Sự Kiện
CaptureBegan
Sự kiện này bắt lửa ngay trước khi lấy được bức chụp màn hình mới.Nó có thể được sử dụng để tùy chỉnh trải nghiệm thu thập, ví dụ bằng cách ẩn các thành phần GUI nhất định.
CaptureEnded
Sự kiện này bắt lửa sau khi hoàn thành việc thu nhận hình ảnh màn hình mới. Nó có thể được sử dụng để khôi phục bất kỳ thay đổi nào được thực hiện khi sự kiện CaptureBegan bắt lửa.
UserCaptureSaved
Sự kiện này xảy ra khi người dùng lưu một bức ảnh màn hình bằng cách sử dụng UI thu thập bức ảnh Roblox.Nó có thể được sử dụng cho phân tích hoặc để yêu cầu người dùng chia sẻ bắt chiếm lấycủa họ.
Tham Số
Các định danh contentId xác định bức ảnh mà người dùng đã lưu.