Poziom API 2.1
Wydana w maju 2017 r.
Najważniejsze zmiany
- Dodaliśmy Przesyłanie bezpośrednie, aby kamery mogły przesyłać dane bezpośrednio na serwery.
- Zawiera nowe polecenia
switchWifi
iuploadFile
. - Do opcji OSC dodano opcje
photoStitchingSupport
,photoStitching
,videoStitchingSupport
,videoStitching
,videoGPSSupport
ivideoGPS
. - Do danych wyjściowych
/osc/info
dodano polecameraId
.
- Zawiera nowe polecenia
- Zastąpiliśmy specyfikację XMP wideo 360 nowym otwartym standardem.
- Dodaliśmy rekomendację dotyczącą określania make/model kamery w filmach 360° w formacie MP4.
Poziom API 2
Wydana w lipcu 2016 r.
Najważniejsze zmiany
- Wycofano polecenia
sessionId
oraz wycofane/zmodyfikowane powiązane polecenia. Poziom 2 interfejsu API jest przeznaczony dla jednego połączenia z klientem. Producenci kamer powinni dbać o to, aby w danym momencie tylko jeden klient (na przykład przez ograniczanie tylko jednego połączenia Wi-Fi) był połączony tylko z jednym klientem.- Wycofane polecenia
startSession
/updateSession
/closeSession
. - Wycofano
sessionId
z danych wejściowych poleceńtakePicture
/getOptions
/setOptions
.
- Wycofane polecenia
- Wycofane polecenia
getImage
/getMetadata
.- Bezwzględny URL pliku jest używany do pobierania bezpośrednio z serwera HTTP kamery.
- Dodane/zmodyfikowane polecenia i opcje dotyczące nagrywania filmów, robienia zdjęć interwałowych i podglądu na żywo.
- Dodano polecenia
startCapture
/stopCapture
/getLivePreview
/processPicture
/reset
. - Zmieniono nazwę
listImages
nalistFiles
oraz zmodyfikowano dane wejściowe i wyjściowe, aby obsługiwać typy wideo i obrazy. - Dodano opcje
previewFormat
,previewFormatSupport
,captureInterval
,captureIntervalSupport
,captureNumber
,captureNumberSupport
,remainingVideoSeconds
,pollingDelay
,delayProcessing
,delayProcessingSupport
iclientVersion
. - Zmodyfikowane opcje:
captureModeSupport
,isoSupport
,shutterSpeedSupport
,fileFormatSupport
,hdr
,hdrSupport
,exposureBracket
iexposureBracketSupport
.
- Dodano polecenia
- Dodaliśmy specyfikację XMP filmu 360.
- Do danych wyjściowych
/osc/info
dodano poleapiLevel
.- apiLevel: pole zostało dodane na poziomie 2 interfejsu API. W przypadku braku tego pola wartość tego pola jest domyślnie uznawana za poziom 1. Obowiązkiem deweloperów jest pobranie tych informacji i zaimplementowanie tych informacji w zależności od wartości.
Zgodność wsteczna
- Producenci kamer: jeśli obsługujesz interfejs API na poziomie 1, zdecydowanie zalecamy, aby przez kilka miesięcy przed końcową aktualizacją zapewnić obsługę zarówno poziomu 1, jak i 2 jako rozwiązania pośredniego, a także zapewnić aktualizację oprogramowania układowego kamer z interfejsem API na poziomie 1. W przeciwnym razie klienty, które obsługują tylko interfejs API na poziomie 1, nie będą działać z Twoimi kamerami.
- Deweloperzy aplikacji: pamiętaj, że te zmiany wpłyną na już opublikowane aplikacje. Twoim obowiązkiem jest wprowadzenie odpowiednich zmian w obu wersjach i przypomnienie właścicielom kamer o konieczności zaktualizowania oprogramowania układowego.