Camera.TakeImage

Enlem/boylam koordinatlarını EXIF'ye kaydederek eş dikdörtgen bir resim çeker (kameranız kendi GPS'ine veya GPS'ine sahipse bağlı cep telefonlarında etkinleştirilmişse). Gerekirse bu komut çağrısından önce camera.setOptions yöntemini çağırın. Bu komut, API düzeyi 2'de değiştirildi.

Parametreler

  • sessionId: camera.startSession Komutdan alınan benzersiz oturum tanımlayıcısı. Bu alan, API düzeyi 2'de kullanımdan kaldırılmıştır.

Sonuçlar

  • API düzeyi 1
    • fileUri: Yakalanan görüntünün URI'si. Mutlak veya göreli URI'ların kullanılıp kullanılmayacağına üreticiler karar verir. Örneğin, "http://android.com/robots.txt" mutlak bir URI, "robots.txt" göreli bir URI'dir. İstemciler bunu opak bir tanımlayıcı olarak işleyebilir.
  • API düzeyi 2
    • fileUrl: Yakalanan görüntünün mutlak URL'sidir. Doğrudan kameranın HTTP sunucusundan indirme yapmak için kullanılabilir. Çekimin tamamlanması (kamerada birleştirme dahil) genellikle biraz zaman aldığından (saniye veya dakikalar arasında değişiklik gösterir) bu komutun fileUrl işlemini hemen döndürmediğini lütfen unutmayın. Komutun ilerlemesi, /osc/commands/status API'si kullanılarak kameranın belirli aralıklarla sorgulanmasıyla elde edilir ve komut tamamlandığında fileUrl sonucu döndürülür. delayProcessing değeri doğru olduğunda önizleme resminin mutlak URL'sidir. Bu, resmi işlemek için transactionResimde giriş olarak kullanılabilir. Aksi takdirde, işlenen nihai resmin mutlak URL'sidir.

Hatalar

  • missingParametre: sessionId eksik. Bu hata kodu, API düzeyi 2'de kullanımdan kaldırılmıştır.
  • geçersizParametreAdı: Parametre adı tanınmıyor. Örneğin, sessionId, API düzeyi 2'de tanınmıyor.
  • geçersizParametre Değeri: Giriş parametresi adı tanındı ancak parametrenin değeri geçersiz. Örneğin, sessionId mevcut değil, artık etkin değil veya veri türü yanlış. Bu hata kodu, API düzeyi 2'de kullanımdan kaldırılmıştır.
  • disabledCommand: Komut şu anda devre dışıdır; örneğin, kamera video çekim modundadır. Bu hata kodu, API düzeyi 2'de eklenmiştir.

Komut G/Ç
Komut Girişi (API düzeyi 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Komut Çıkışı (API düzeyi 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
Komut Çıkışı (Hata) (API düzeyi 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Komut Girişi (API düzeyi 2) 
none
Komut Çıkışı (API düzeyi 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Komut Çıkışı (Hata) (API düzeyi 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}