CaptureService
*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.
Yakalama Hizmeti geliştiricilerin ekran görüntüsü yakalama özelliğinin deneyimlerine nasıl entegre edileceğini kontrol etmelerine izin veren bir istemci tarafı hizmetidir.Bir kullanıcı için otomatik olarak bir ekran görüntüsü alındığında önceden ayarlanmış anları içerebilir ve o kullanıcı daha sonra ekran görüntüsünü kaydedebilir, paylaşabilir veya silabilir.
Özet
Özellikler
Yöntemler
Bir ekran görüntüsü alır ve tanımlamak için geçici bir contentId sağlar.
Kullanıcıya belirtilen kayıtları galerisine kaydetmesini ister.
- PromptShareCapture(captureContent : Content,launchData : string,onAcceptedCallback : function,onDeniedCallback : function):()
Belirtilen bir ekran görüntüsü yakalamasını paylaşmak için kullanıcıyı teşvik eder.
Etkinlikler
Bir ele geçirme başlamadan hemen önce ateş eder.
Bir ele geçirme işlemi bitince ateş eder.
Kullanıcı bir yakalakaydettiğinde ateş eder.
Özellikler
Yöntemler
CaptureScreenshot
Bu yöntem, kullanıcı için bir ekran görüntüsü alır, ancak deneyimin ana menüsündeki Yakalar galerisine hemen kaydetmez.Bunun yerine, yeni yakalatanımlamak için geçici bir contentId oluşturulur.
onCaptureReady geri arama, kullanıcıya ekran görüntüsünü kaydetmesini veya paylaşmasını istemek için kullanılabilir:
local CaptureService = game:GetService("CaptureService")
-- Bu kodu içeren senaryonun bir ImageLabel ebeveynine referans
local imageLabel = script.Parent
local function onCaptureReady(contentId)
imageLabel.Image = contentId
end
CaptureService:CaptureScreenshot(onCaptureReady)
Parametreler
Yeni yakalama ile çağrılan bir geri çağrılma işlevi, hazır olduğunda contentId .
Dönüşler
PromptSaveCapturesToGallery
Bu yöntem, kullanıcıya sağlanan contentIds tarafından tanımlanan ekran görüntülerini deneyimin ana menüsündeki Yakalar galerisine kaydetmesini ister.
Parametreler
Bir kullanıcının bu yakalamayı kabul ettiğini gösteren bir boolean ifade eden bir sözcük haritalamasıyla çağrılacak bir geri arama işlevi. A callback function that will be invoked with a dictionary mapping each contentId.
Dönüşler
PromptShareCapture
Bu yöntem, kullanıcıya verilen contentId yerel paylaşım sayfasını kullanarak tanımlanan ekran görüntüsünü cihazlarında paylaşmasını istemektedir.
Kapatma görüntüsü, desteklendiğinde deneyime bir davet bağlantısı ile birlikte paylaşılır.Tüm cihazlar hem ekran görüntüsü hem de davet bağlantısını desteklemiyor.
launchData davet bağlantısı aracılığıyla katılan kullanıcılar için launchData alanında mevcut olacak.
Bu yöntemi çağırırken bir hata oluşmaması için önce PolicyService:GetPolicyInfoForPlayerAsync() 'yi arayın ve döndürülen sözlükte IsContentSharingAllowed 'nin doğru olduğundan emin olun.
Parametreler
Davet bağlantısında başlatma verileri olarak dahil edilecek opcional bir dize.
Kullanıcı paylaşmayı kabul ederse, isteğe bağlı bir geri arama işlevi çağrılır.
Kullanıcı paylaşmayı reddederse, isteğe bağlı bir geri arama işlevi çağrılır.
Dönüşler
TakeCapture
Parametreler
Dönüşler
Etkinlikler
CaptureBegan
Bu etkinlik, yeni bir ekran görüntüsü alınmadan hemen önce ateşlenir.Örneğin, belirli GUI öğelerini gizleyerek yakalama deneyimini özelleştirmek için kullanılabilir.
CaptureEnded
Bu etkinlik, yeni bir ekran görüntüsü alımı tamamlandıktan sonra ateşlenir. CaptureBegan etkinliği ateşlendiğinde yapılan herhangi bir değişikliği geri yükleme için kullanılabilir.
UserCaptureSaved
Bu olay, kullanıcı Roblox ekran görüntüsü yakalama arayüzü kullanarak bir ekran görüntüsü kaydettiğinde ateşlenir.Analiz için veya kullanıcının yakaladıklarını paylaşmasını istemek için kullanılabilir.
Parametreler
Kullanıcının kaydettiği ekran görüntüsünü tanımlayan contentId .