CaptureService
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
CaptureService adalah layanan sisi klien yang memungkinkan pengembang untuk mengontrol bagaimana fitur penangkapan tangkapan layar terintegrasi dengan pengalaman mereka.Ini dapat digunakan untuk menyertakan momen default di mana tangkapan layar diambil secara otomatis untuk pengguna, dan pengguna tersebut kemudian dapat menyimpan, berbagi, atau menghapus tangkapan layar.
Rangkuman
Metode
Mengambil tangkapan layar dan memberikan sementara contentId untuk mengidentifikasinya.
Meminta pengguna untuk menyimpan tangkapan yang ditentukan ke galeri mereka.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Meminta pengguna untuk berbagi tangkapan layar tertentu.
- StartVideoCaptureAsync(onCaptureReady : function,captureParams : Dictionary):Enum.VideoCaptureStartedResult
Acara
Api segera sebelum penangkapan dimulai.
Api setelah penangkapan selesai.
Melepaskan api saat pengguna menyimpan tangkapan.
Properti
Metode
CaptureScreenshot
Metode ini menangkap tangkapan layar untuk pengguna tetapi tidak segera menyimpannya ke galeri Tangkapan mereka dalam menu utama pengalaman.Sebagai gantinya, sementara contentId dibuat untuk mengidentifikasi penangkapan baru.
Panggilan balik onCaptureReady dapat digunakan untuk meminta pengguna untuk menyimpan atau berbagi tangkapan layar:
local CaptureService = game:GetService("CaptureService")
-- Referensi ke Label Gambar orangtua skrip yang berisi kode ini
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parameter
Fungsi panggil balasan yang dipanggil dengan contentId dari penangkapan baru setelah selesai.
Memberikan nilai
PromptSaveCapturesToGallery
Metode ini meminta pengguna untuk menyimpan tangkapan layar yang diidentifikasi oleh contentIds yang disediakan ke galeri Tangkapan dalam menu utama pengalaman.
Parameter
Fungsi panggil balasan yang akan dipanggil dengan peta kamus masing-masing contentId ke boolean yang menunjukkan apakah pengguna menerima penyimpanan yang ditangkap itu.
Memberikan nilai
PromptShareCapture
Metode ini meminta pengguna untuk berbagi tangkapan layar yang diidentifikasi oleh share sheet bawaan di perangkat mereka menggunakan share sheet bawaan.
Gambar penangkapan dibagikan bersama dengan tautan undangan ke pengalaman saat didukung.Tidak semua perangkat mendukung termasuk screenshot dan tautan undangan.
The launchData akan tersedia di bidang launchData untuk pengguna yang bergabung melalui tautan undangan.
Untuk menghindari kesalahan saat memanggil metode ini, pertama-tama panggil PolicyService:GetPolicyInfoForPlayerAsync() dan periksa apakah IsContentSharingAllowed benar dalam kamus yang dikembalikan.
Parameter
String opsional untuk dimasukkan sebagai data peluncuran dalam tautan undangan.
Fungsi panggil balasan opsional diaktifkan jika pengguna menerima berbagi.
Fungsi panggil balasan opsional diaktifkan jika pengguna menolak berbagi.
Memberikan nilai
StopVideoCapture
Memberikan nilai
TakeCapture
Parameter
Memberikan nilai
StartVideoCaptureAsync
Parameter
Memberikan nilai
Acara
CaptureBegan
Acara ini terjadi tepat sebelum tangkapan layar baru dilakukan.Ini dapat digunakan untuk menyesuaikan pengalaman penangkapan, misalnya dengan menyembunyikan elemen GUI tertentu.
Parameter
CaptureEnded
Peristiwa ini terjadi setelah penangkapan tangkapan layar baru selesai. Ini dapat digunakan untuk memulihkan setiap perubahan yang dilakukan saat peristiwa CaptureBegan terjadi.
Parameter
UserCaptureSaved
Acara ini terjadi saat pengguna menyimpan tangkapan layar menggunakan UI tangkapan layar Roblox.Ini dapat digunakan untuk analitik atau untuk meminta pengguna untuk berbagi tangkapan mereka.
Parameter
The contentId mengidentifikasi tangkapan layar yang disimpan oleh pengguna.