CaptureService

Hiển Thị Bản Đã Lỗi Thời

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

Không Thể Tạo
Dịch Vụ

CaptureService là một dịch vụ bên client cho phép các nhà phát triển kiểm soát cách tính năng quay màn hình được tích hợp với trải nghiệm của họ. Nó có thể được sử dụng để bao gồm các khoảnh khắc để lưu tự động cho một người dùng, và người dùng đó có thể sau đó

Tóm Tắt

Phương Pháp

  • CaptureScreenshot(onCaptureReady : function):void

    Làm một bản chụp màn hình và cung cấp một bản tạm thời contentId để xác định nó.

  • PromptSaveCapturesToGallery(contentIds : Array,resultCallback : function):void

    Yêu cầu người dùng lưu những kẻ bắt có định vào hồ sơ của họ.

  • PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void

    Yêu cầu người dùng chia sẻ một bức chiếm lấymàn hình được chỉ định.

Sự Kiện

Thuộc Tính

Phương Pháp

CaptureScreenshot

void

Phương pháp này tạo một bản chụp màn hình cho người dùng nhưng không ngay lập tức lưu vào ảnh Captures của họ trong menu chính của trải nghiệm. Thay vào đó, một bản chụp tạm thời contentId được tạo để xác định người bắt chiếm lấymới.

onCaptureReady có thể được sử dụng để kêu gọi người dùng lưu hoặc chia ảnh chụp màn hình:


local CaptureService = game:GetService("CaptureService")
-- Tham khảo một ImageLabel cha của script chứa mã này
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)

Tham Số

onCaptureReady: function

Một hàm chức năng được gọi với contentId của một mục tiêu mới khi nó đã sẵn sàng.


Lợi Nhuận

void

PromptSaveCapturesToGallery

void

Phương thức này yêu cầu người dùng lưu các bản in màn hình được xác định bởi cung cấp contentIds vào Captures điều hành trong menu chính của trải nghiệm.

Tham Số

contentIds: Array

Một dàn contentId chuỗi xác định các khoảnh khắc màn hình để lưu.

resultCallback: function

Một hàm chức năng sẽ được gọi với một bản định nghĩa từ điển mỗi contentId đến một hàm chức năng cho phép người dùng đã chấp nhận lưu những gì đã bị chiếm lấy.


Lợi Nhuận

void

PromptShareCapture

void

Phương pháp này yêu cầu người dùng chia sẻ bản sao màn hình được xác định bằng cách sử dụng trang chia sẻ người dùng trên thiết bị của họ.

Hình ảnh cướp sẽ được chia sẻ cùng với một 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ị/ứng dụng hỗ trợ cả một hình ảnh màn hình và một liên kết mời.

Dữ liệu phát hành launchData sẽ được lưu trong trường launchData cho người dùng tham gia thông qua liên kết mời.

Tham Số

contentId: ContentId

The contentIdIdentifying the screenshot to chia sẻ.

launchData: string

Một dòng chuỗi tùy chọn để bao gồm là dữ liệu khởi động trong liên kết mời.

onAcceptedCallback: function

Một chức năng gọi lại tùy chọn được gọi nếu người dùng chấp nhận chia sẻ.

onDeniedCallback: function

Một chức năng gọi lại tùy chọn được gọi nếu người dùng từ chối chia sẻ.


Lợi Nhuận

void

Sự Kiện

CaptureBegan

Sự kiện này bắt đầu ngay trước khi một bức ảnh màn hình mới được lưu. Nó có thể được sử dụng để tùy chỉnh trải nghiệm bắt đầu, chẳng hạn như ẩn các thành phần GUI nhất định.


CaptureEnded

Sự kiện này được tích hợp sau khi một bức ảnh màn hình mới được hoàn thành. Nó có thể được sử dụng để khôi phục bất kỳ thay đổi đã được thực hiện khi sự kiện CaptureBegan đã bắt đầu.


UserCaptureSaved

Sự kiện này bắt đầu khi người dùng lưu một bản chụp màn hình bằng cách sử dụng UI bắt chục màn hình Roblox. Nó có thể được sử dụng cho phân tích hoặc để kêu gọi người dùng chia sẻ chiếm lấychụp của họ.

Tham Số

captureContentId: ContentId

The contentIdIdentifying the screenshot that the user saved.