CaptureService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
CaptureService adalah layanan pihak klien yang memungkinkan pengembang untuk mengontrol cara fitur tangkapan layar dapat digunakan dengan pengalaman mereka. Ini dapat digunakan untuk meng包括 momen prasetel di mana tangkapan layar otomatis diambil untuk pengguna, dan pengguna kemudian dapat menyimpan, bagikan, atau menghapus screenshot.
Rangkuman
Metode
Mengambil tangkapan layar dan memberikan contentId sementara untuk mengidentifikasi itu.
Mendesak pengguna untuk menyimpan tangkapan yang ditentukan ke galeri mereka.
- PromptShareCapture(contentId : ContentId,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):void
Mendesak pengguna untuk berbagi tangkapan layar yang ditentukan.
Acara
Mengambil api segera sebelum ambilan dimulai.
Diaktifkan setelah sebuah captures selesai.
Diaktifkan saat pengguna menyimpan tangkapan.
Properti
Metode
CaptureScreenshot
Metode ini menangkap tangkapan layar untuk pengguna tetapi tidak segera menyimpannya ke galeri ContentId pengguna di menu utama pengalaman. Sebaliknya, akan dibuat contentId sementara untuk mengidentifikasi ambilbaru.
Panggilan onCaptureReady dapat digunakan untuk mengingatkan pengguna untuk menyimpan atau berbagi tangkapan screenshot:
local CaptureService = game:GetService("CaptureService")
-- Referensi pada Label Gambar orang tua dari script yang berisi kode ini
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parameter
Fungsi panggilan yang disebut dengan contentId dari capturing baru setelah siap.
Memberikan nilai
PromptSaveCapturesToGallery
Metode ini menginstruksikan pengguna untuk menyimpan tangkapan layar yang diidentifikasi oleh contentIds yang disediakan ke galeri Captures mereka di menu utama pengalaman.
Parameter
Sebuah matriks contentId string yang mengidentifikasi tangkapan layar untuk disimpan.
Fungsi panggilan yang akan dianggil dengan peta kata sandi setiap contentId ke boolean menunjukkan apakah pengguna menerima menyimpan yang ambilitu.
Memberikan nilai
PromptShareCapture
Metode ini menginstruksikan pengguna untuk berbagi tangkapan layar yang diidentifikasi oleh contentId menggunakan halaman berbagi natif di perangkat mereka.
Gambar tangkapan akan dibagikan bersama dengan tautan undangan ke pengalaman ketika didukung. Tidak semua perangkat/ứng dụng mendukung termasuk tangkapan layar dan tautan tautkan.
launchData akan tersedia di bidang launchData untuk pengguna yang bergabung melalui tautan tautkan.
Parameter
ContentId mengidentifikasi tangkapan layar untuk dibagikan.
String opcional untuk dianggap sebagai data peluncuran di tautan tautkan.
Fungsi panggilan op션 yang diaktifkan jika pengguna menerima berbagi.
Fungsi panggilan op션 yang diaktifkan jika pengguna menolak berbagi.
Memberikan nilai
Acara
CaptureBegan
Acara ini menyetel tepat sebelum tangkapan layar baru diambil. Ini dapat digunakan untuk menyesuaikan pengalaman menangkap, misalnya dengan menyembunyikan beberapa elemen GUI tertentu.
CaptureEnded
Acara ini diaktifkan setelah pemotretan layar baru selesai. Ini dapat digunakan untuk mengembalikan perubahan apa pun yang dilakukan ketika acara CaptureBegan diaktifkan.
UserCaptureSaved
Acara ini diaktifkan ketika pengguna menyimpan tangkapan layar menggunakan UI tangkapan layar Roblox. Ini dapat digunakan untuk analitik atau untuk mengingatkan pengguna untuk berbagi tangkapan ambilmereka.
Parameter
ContentId mengidentifikasi tangkapan layar yang disimpan pengguna.