Camera.startCapture

Seçenekler'deki captureMode değerine bağlı olarak video yakalamayı veya aralıklı resim yakalamayı başlatır. Bu komut, API düzeyi 2'de eklenmiştir.

Parametreler

  • Bu komutun istek gövdesinde parametresi yok. Aralıklı resim çekimi veya video çekimi, captureMode seçeneği tarafından belirlenir. Aralıklı yakalama için, açık uçlu yakalama olup olmaması captureNumber değerinin 0'a eşit veya 0'dan büyük olmasına bağlıdır. captureMode, captureInterval ve captureNumber, aralıklı çekimden önce ayarlanmalıdır. Video çekiminden önce yalnızca captureMode öğesinin "video" olarak ayarlanması gerekir. Bu ayar yalnızca camera.stopCapture komutuyla durdurulabilir.

Sonuçlar

  • Açık uçlu yakalama (catMode == "video" veya reCAPTCHANumber == 0 olduğunda)
    • Sonuç yok.
  • Açık uçlu olmayan aralıklı yakalama:
    • fileUrls: Aralıklı yakalama için resim dosyalarına işaret eden bir mutlak URL listesidir. Yakalamanın tamamlanması captureNumber sürdüğü için bu komutun hemen fileUrls döndürmediğini lütfen unutmayın. Komutun ilerlemesi, kameraya düzenli olarak sorgu gönderilerek elde edilebilir. Örneğin, /osc/commands/status API kullanılarak tahmini bir süreden (time = captureInterval * (captureNumber - 1)) sonra anket yapılır ve komut tamamlandığında fileUrls döndürülür. Komut başarıyla tamamlanmazsa (ör. kameranın pili bitmeden önce yalnızca 3 resim çekildiyse) veya kameranın ortadaki istemci telefonla bağlantısı kesilirse ancak komut başarıyla tamamlanırsa istemci ile kamera arasında yeni bir bağlantı kurulduğunda istemci daha sonra camera.listFiles kullanarak görüntüleri alabilir.

Hatalar

  • DisableCommand: Komut şu anda devre dışıdır. Örneğin, kamera bir video çekiminin veya aralıklı yakalamanın ortasındadır.
  • geçersizParametreAdı: Parametre adı tanınmıyor. Örneğin, sessionId adlı parametre tanınmıyor.

Komut G/Ç
Komut Girişi 
none
Komut Çıktısı 
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Komut Çıktısı (Hata) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}