CameraX

Ta tabela zawiera wszystkie artefakty w grupie androidx.camera.

Testowanie urządzeń

Biblioteka CameraX jest testowana na wielu urządzeniach w naszej pracowni. Aby zobaczyć listę urządzeń, które obecnie znajdują się w module, zapoznaj się z artykułem Urządzenia przetestowane w aparacie CameraX.

Deklarowanie zależności

Aby dodać zależność od CameraX, musisz dodać do projektu repozytorium Google Maven. Więcej informacji znajdziesz w repozytorium Maven firmy Google.

Dodaj zależności dla artefaktów, których potrzebujesz, w pliku build.gradle aplikacji lub modułu:

dependencies {
  // CameraX core library using the camera2 implementation
  def camerax_version = "1.5.0-alpha03"
  // The following line is optional, as the core library is included indirectly by camera-camera2
  implementation "androidx.camera:camera-core:${camerax_version}"
  implementation "androidx.camera:camera-camera2:${camerax_version}"
  // If you want to additionally use the CameraX Lifecycle library
  implementation "androidx.camera:camera-lifecycle:${camerax_version}"
  // If you want to additionally use the CameraX VideoCapture library
  implementation "androidx.camera:camera-video:${camerax_version}"
  // If you want to additionally use the CameraX View class
  implementation "androidx.camera:camera-view:${camerax_version}"
  // If you want to additionally add CameraX ML Kit Vision Integration
  implementation "androidx.camera:camera-mlkit-vision:${camerax_version}"
  // If you want to additionally use the CameraX Extensions library
  implementation "androidx.camera:camera-extensions:${camerax_version}"
}

dependencies {
    // CameraX core library using the camera2 implementation
    val camerax_version = "1.5.0-alpha03"
    // The following line is optional, as the core library is included indirectly by camera-camera2
    implementation("androidx.camera:camera-core:${camerax_version}")
    implementation("androidx.camera:camera-camera2:${camerax_version}")
    // If you want to additionally use the CameraX Lifecycle library
    implementation("androidx.camera:camera-lifecycle:${camerax_version}")
    // If you want to additionally use the CameraX VideoCapture library
    implementation("androidx.camera:camera-video:${camerax_version}")
    // If you want to additionally use the CameraX View class
    implementation("androidx.camera:camera-view:${camerax_version}")
    // If you want to additionally add CameraX ML Kit Vision Integration
    implementation("androidx.camera:camera-mlkit-vision:${camerax_version}")
    // If you want to additionally use the CameraX Extensions library
    implementation("androidx.camera:camera-extensions:${camerax_version}")
}

Opinia

Twoja opinia pomoże nam ulepszyć Jetpack. Daj nam znać, jeśli odkryjesz nowe wydania lub masz pomysły na ulepszenie tej biblioteki. Zanim utworzysz nową bibliotekę, przejrzyj istniejące problemy w tej bibliotece. Możesz dodać swój głos do istniejącego problemu, klikając przycisk z gwiazdką.

Tworzenie nowego zgłoszenia

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wizjer aparatu w wersji 1.0

Wersja 1.0.0-alpha02

12 czerwca 2024 r.

androidx.camera:camera-viewfinder-compose:1.0.0-alpha02 został zwolniony. Wersja 1.0.0-alpha02 zawiera te komity.

Wersja 1.0.0-alpha01

14 maja 2024 r.

androidx.camera:camera-viewfinder-compose:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 zawiera te komity.

Nowe funkcje

• Nowa biblioteka. Biblioteka ta zawiera element Viewfinder, który można używać w Compose. Element ten jest natywnie obsługiwany przez CameraX i Camera2. Składany wizjer obsługuje różne formaty obrazu i obsługę zdarzeń dotykowych.

Wyświetlacz aparatu w wersji 1.4

Wersja 1.4.0-alpha07

12 czerwca 2024 r.

androidx.camera:camera-viewfinder:1.4.0-alpha07 i androidx.camera:camera-viewfinder-core:1.4.0-alpha07 są dostępne. Wersja 1.4.0-alpha07 zawiera te komisy.

Wersja 1.4.0-alpha06

14 maja 2024 r.

androidx.camera:camera-viewfinder:1.4.0-alpha06 i androidx.camera:camera-viewfinder-core:1.4.0-alpha06 są dostępne. Wersja 1.4.0-alfa06 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Zmień nazwy typów enumeracji Viewfinder, aby lepiej odzwierciedlały implementacje na poziomie źródła, i dodaj stałe wartości dla TransformationInfo.sourceRotation.ImplementationMode (Ic6149)
• Dodano ZoomGestureDetector.ZoomEvent, aby uwzględnić stany gestu powiększenia. (I84cdf)

Wersja aplikacji Aparat: 1.5

Wersja 1.5.0-alpha03

30 października 2024 r.

androidx.camera:camera-*:1.5.0-alpha03 został zwolniony. Wersja 1.5.0-alfa03 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Dodaj interfejsy API formatu wyjściowego dla RAW i RAW + JPEG ImageCapture, a sprawdzanie możliwości urządzenia jest dostępne w ImageCaptureCapabilities#getSupportedOutputFormats. OUTPUT_FORMAT_RAW służy do przechwytywania obrazu RAW, który jest formatem Adobe DNG, a OUTPUT_FORMAT_RAW_JPEG do jednoczesnego przechwytywania obrazów RAW i JPEG. Nowy interfejs API ImageCapture#takePicture służy do jednoczesnego przechwytywania obrazów. Musi on przekazywać 2 wartości OutputFileOptions: pierwsza to wartość dla obrazu RAW, a druga – dla obrazu JPEG. (Ib0f3d)

Poprawki błędów

• Rozwiązaliśmy problem z podeksponowaniem podglądu i filmu na urządzeniach TCL, gdy włączona jest opcja VideoCapture. (Id7a64).
• Rozwiązaliśmy problem, który powodował, że wywołanie startFocusMetering z PreviewView.getMeteringPointFactory nie powodowało uzyskania prawidłowych współrzędnych czujnika, gdy efekt jest włączony lub gdy są powiązane 4 przypadki użycia (udostępnianie strumienia). (I916c5, b/345993685)
• Naprawiono błąd, który powodował, że zdarzenie VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE nie było aktywowane podczas nagrywania filmu, gdy nie było wystarczająco dużo miejsca na dane. (I35779, b/356399842)

Wersja 1.5.0-alpha02

2 października 2024 r.

androidx.camera:camera-*:1.5.0-alpha02 został zwolniony. Wersja 1.5.0-alfa02 zawiera te zatwierdzenia.

Nowe funkcje

• Nowe interfejsy API do wysyłania zapytań o funkcje aparatu obsługiwane przez urządzenie. Na przykład sprawdzenie, czy HDR i 60 FPS mogą być włączone jednocześnie. Zawiera 2 elementy: camera-feature-combination-query i camera-feature-combination-query-play-services. To zgodna wersja interfejsu API CameraManager#getCameraDeviceSetup#isSessionConfigurationSupported interfejsu Camera2 z dodatkowymi danymi dostarczanymi przez Usługi Google Play.

Poprawki błędów

• Rozwiązano problem z docelową liczbą klatek Preview/VideoCapture na urządzeniach na poziomie STAREGO. Docelowa częstotliwość klatek ustawiona za pomocą interfejsu API setTargetFrameRate lub Camera2Interop była zawsze zastępowana wartością podaną przez AeFpsRangeLegacyQuirk. Dzięki tej poprawce biblioteka CameraX będzie uwzględniać wartość ustawioną za pomocą interfejsu API setTargetFrameRate lub Camera2Interop. (Ie2d32)
• Dodano funkcje lampy błyskowej, latarki i 3A do robienia zdjęć za pomocą CameraEffect. Zdjęcia wykonane z użyciem CameraEffect powinny teraz mieć takie same przetwarzanie przed i po wykonaniu zdjęcia (np. uruchamianie lampy błyskowej, konwergencja 3A itp., w stosownych przypadkach) jak zdjęcia bez CameraEffect. (I5ff30)
• Wykluczono problematyczne rozmiary wyjściowe w przypadku formatu ImageAnalysis na urządzeniu Samsung SM-A057G. Jeśli ImageAnalysis używa rozdzielczości większej lub równej 1920 x 1440, może to spowodować problem z czarnym podglądem. Na urządzeniu SM-A057G zastosowano ExcludedSupportedSizesQuirk, aby uniknąć problemu. (I63dfe, b/365877975)
• Rozwiązaliśmy problem z docelową liczbą klatek (Preview/VideoCapture), gdy mechanizm udostępniania strumienia jest włączony wewnętrznie w celu udostępniania strumienia na platformach Preview i VideoCapture. (I4fdac)
• Włączono obejście, aby rozwiązać problem związany z nieprawidłowymi metadanymi obrazu JPEG na urządzeniach Samsung S10e i S10+. Po naprawieniu CameraX może zapisać obraz JPEG lub prawidłowe obiekty Bitmap mogą zostać zwrócone podczas wywołania funkcji ImageProxy.toBitmap() na tych urządzeniach, jeśli wystąpi problem z nieprawidłowymi metadanymi obrazu JPEG. (Iae493, b/356428987)
• Wyłączone rozszerzenia tylnego aparatu Samsung A52s o identyfikatorze 0, ponieważ podczas robienia zdjęć HDR i konfigurowania sesji nagrywania w trybie BOKEH lub FACE_RETOUCH mogą wystąpić awarie natywne. (I03ec9, b/364152642)
• Naprawiono błąd, który powodował, że zdarzenie VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE nie było aktywowane podczas nagrywania filmu, gdy nie było wystarczająco dużo miejsca na dane. (Ia5b4f, b/356399842)
• Rozwiązanie problemu polegającego na tym, że druga próba nagrania filmu na Oppo A5 (CPH1931) kończyła się niepowodzeniem. (I181d6)

Wersja 1.5.0-alpha01

4 września 2024 r.

Usługa androidx.camera:camera-*:1.5.0-alpha01 została zwolniona. Wersja 1.5.0-alpha01 zawiera te komity.

Zmiany w interfejsie API

• Udostępnij interfejs API, aby skonfigurować ustawienia kompozycji na potrzeby podwójnego jednocześnie nagrywania wideo kamerą. Ustawienia obejmują wartość alfa do mieszania, przesunięcie w swoich współrzędnych x, y, skalę szerokości i wysokości okna wyświetlania obrazu z kamery. Odsunięcie, szerokość i wysokość są określone w skali 1:1. (Ia2b8a)
• Udostępniono CameraProvider.getCameraInfo jako formalny interfejs API. (I901cd)
• Dodano interfejs API PendingRecording.withAudioEnabled(boolean initialMuted) do kontrolowania początkowego stanu wyciszenia. (I635c3, b/354829267)

Poprawki błędów

• Naprawiono awarię, która występowała, gdy wywołano funkcję bindToLifecycle, a obiekt LifecycleOwner został zniszczony. (I6e6d8)
• Rozwiązano problem z czarnym ekranem w przedniej kamerze podczas łączenia z VideoCapture na telefonie Motorola Edge 20 Fusion. (I1fe88)
• Zoptymalizowaliśmy konfigurację wykrywania gestów powiększania w PreviewView, aby poprawić płynność. (I04ffc)

Wersja aparatu 1.4

Wersja 1.4.0

30 października 2024 r.

androidx.camera:camera-*:1.4.0 został zwolniony. Wersja 1.4.0 zawiera te komitowane zmiany.

Ważne zmiany od wersji 1.3.0

Aplikacja CameraX w wersji 1.4.0 zawiera mnóstwo ciekawych nowości. Podsumowanie:

Główna funkcja: 10-bitowy HDR:

• Łatwo robić niesamowite zdjęcia i filmy HDR.
• Obsługuje HLG i kodowanie HEVC 10-bitowe.
• Korzystaj z podglądu 10-bitowego HDR i sprawdzaj możliwości urządzenia.
• Działa z obrazami UltraHDR i filmami HDR na coraz większej liczbie urządzeń.

Inne przydatne funkcje:

• Rozszerzenia Kotlina: dodano funkcje zawieszania takePicture i awaitInstance.
• Efekty w czasie rzeczywistym: możesz stosować efekty takie jak znak wodny i podświetlenie obiektu.
• Interfejs CameraController API: nowe opcje konfiguracji nagrywania wideo.
• Stabilizacja podglądu: zapytanie o możliwości urządzenia i włączenie stabilizacji.
• Ulepszenia funkcji nagrywania wideo: większa kontrola nad jakością i dostęp do wyższych rozdzielczości.
• Integracja z rozszerzeniami CameraX: płynna integracja z aplikacją VideoCapture i nowymi funkcjami ImageCapture.
• Shutter Sound API: łatwe sprawdzanie regionalnych wymagań dotyczących dźwięku migawki.
• Lampa ekranu: ulepszone zdjęcia w słabym oświetleniu z przedniego aparatu.
• Interfejsy API metadanych rozszerzeń aparatu: interfejsy API obsługujące dostosowywanie siły rozszerzeń i otrzymywanie powiadomień o aktualnym trybie rozszerzeń w ExtensionMode#AUTO. Więcej informacji o poprawkach błędów znajdziesz w ogłoszeniach dotyczących wersji beta i RC.

Wersja 1.4.0-rc04

16 października 2024 r.

androidx.camera:camera-*:1.4.0-rc04 został zwolniony. Wersja 1.4.0-rc04 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że wywołanie funkcji startFocusMetering za pomocą funkcji PreviewView.getMeteringPointFactory nie otrzymuje prawidłowych współrzędnych czujnika, gdy włączony jest efekt lub gdy powiązane są 4 przypadki użycia (udostępnianie strumienia). (I916c5, b/345993685)

Wersja 1.4.0-rc03

2 października 2024 r.

androidx.camera:camera-*:1.4.0-rc03 został zwolniony. Wersja 1.4.0-rc03 zawiera te komisy.

Poprawki błędów

• Dodano funkcje lampy błyskowej, latarki i 3A do robienia zdjęć za pomocą CameraEffect. Zdjęcia wykonane z użyciem CameraEffect powinny teraz mieć takie same przetwarzanie przed i po wykonaniu zdjęcia (np. uruchamianie lampy błyskowej, konwergencja 3A itp., w stosownych przypadkach) jak zdjęcia bez CameraEffect. (I5ff30)
• Zoptymalizowano płynność ściągnięcia palców w celu powiększenia w aplikacji PreviewView (I04ffc).
• Odłączenie ultra HDR od obsługi 10-bitowego wyjścia, ponieważ obsługa ultra HDR nie wymaga już 10-bitowego wyjścia. (I96ff2, I0c3b3)

Wersja 1.4.0-rc02

18 września 2024 r.

androidx.camera:camera-*:1.4.0-rc02 został zwolniony. Wersja 1.4.0-rc02 zawiera te komisy.

Poprawki błędów

• Naprawiono awarię, która powodowała wywołanie metody bindToLifecycle z zniszczonym LifecycleOwner. (I6e6d8)
• Dodano animację widoczności w ScreenFlashView na urządzeniu ScreenFlash#apply. Poprawiono też błędy spowodowane asynchroniczną zmianą jasności po pewnym czasie. (I37cdb)
• Zwiększono płynność powiększenia dzięki zastąpieniu ustawień powiększenia w ramach platformy na obsługiwanych urządzeniach.

Wersja 1.4.0-rc01

7 sierpnia 2024 r.

androidx.camera:camera-*:1.4.0-rc01 został zwolniony. Wersja 1.4.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

• Dodano eksperymentalną funkcję CameraInfo.getCameraInfo, która umożliwia wyświetlanie konkretnych informacji o aparacie bez konieczności wiązania przypadków użycia z aparatem. (I550d1)

Zmiany interfejsu API

• Dodano interfejsy API PreviewView.getScreenFlash i PreviewView.setScreenFlashOverlayColor na wypadek, gdy element ScreenFlashView nie zostanie dodany w sposób jawny. (I43945)

Poprawki błędów

• Rozwiązaliśmy problemy z ekspozycją i odcieniami kolorów w przypadku obrazu zarejestrowanego przy włączonym świetle błyskowym w warunkach słabego oświetlenia w ramach ograniczonego przypadku użycia funkcji VideoCapture. (Ic9814)
• Rozwiązanie problemu polegający na tym, że przerwanie zapytania takePicture z włączonymi rozszerzeniami może spowodować nieotrzymanie wyniku, a następne zapytanie takePicture może przestać działać. (Iae78f)
• Rozwiązaliśmy problem z wyciekiem pamięci występujący po włączeniu rozszerzeń. (Iab276)
• Rozwiązano problem z nieprawidłowym działaniem rozszerzeń CameraX na urządzeniach takich jak Pixel 7/8 i Samsung Galaxy S24. Problem ten wynikał z problemu z konwersją Camera2OutputConfigImpl w trybie wersji i pojawił się po uaktualnieniu AGP do wersji 8.5.1 i włączeniu minifikacji. (I99598, b/354824993)

Wersja 1.4.0-beta02

12 czerwca 2024 r.

androidx.camera:camera-*:1.4.0-beta02 został zwolniony. Wersja 1.4.0-beta02 zawiera te komity.

Zmiany w interfejsie API

• Podobnie jak w przypadku VideoCapture, dodaj setMirrorMode dla przypadku użycia Podgląd. Obsługa trybu lustrzanego włączonego i wyłączonego dla strumienia podglądu za pomocą OutputConfiguration.setMirrorMode od poziomu interfejsu API 33 lub nowszego. W przypadku starszych interfejsów API ta funkcja będzie bezczynna. (I821f4)

Poprawki błędów

• Rozwiązano problem polegający na tym, że aplikacje nie mogły robić zdjęć na urządzeniu Samsung Tab A8, gdy ImageCapture wybierało 1920 x 1080 w kombinacji Preview + VideoCapture + ImageCapture UseCase. (I5a463, b/336925549)
• Naprawiono błąd, który powodował, że nagrywanie trwałe mogło nie być kontynuowane po przełączeniu kamery. (Icb0a1)

Wersja 1.4.0-beta01

14 maja 2024 r.

Usługa androidx.camera:camera-*:1.4.0-beta01 została zwolniona. Wersja 1.4.0-beta01 zawiera te komity.

Zmiany w interfejsie API

• Dodano ZoomGestureDetector.ZoomEvent, aby zawierać stany gestu powiększania. (I84cdf)

Poprawki błędów

• Rozwiązano błąd, który powodował, że przechwytywanie i ustawienie ostrości przez dotknięcie nie używały wartości powtarzających się żądań w trybie FPS/stabilizacji, co mogło powodować ponowne tworzenie sesji przechwytywania i problemy z opóźnieniem lub zacinanie się podglądu na niektórych urządzeniach. (I7dc0b)
• Naprawiono błąd, który powodował, że na niektórych urządzeniach nie można było wybrać wysokiej rozdzielczości, gdy włączona jest aplikacja CameraEffect. (np. 4000 x 3000 na Samsungu A32 5G). (IE3ed3, b/337336152)
• Rozwiązano problem z zawieszaniem się podczas robienia zdjęć w podglądzie. ImageCapture i VideoCapture(UHD) są powiązane z Pixel 4XL API29. (I5b288)
• Obsługa urządzeń wirtualnych: kontekst przekazywany do funkcji ProcessCameraProvider zachowa identyfikator urządzenia, aby zapewnić jego działanie w środowisku urządzenia wirtualnego. (I5ba48)

Wersja 1.4.0-alpha05

17 kwietnia 2024 r.

androidx.camera:camera-*:1.4.0-alpha05 został zwolniony. Wersja 1.4.0-alpha05 zawiera te komisy.

Nowe funkcje

• Konwersja ProcessCameraProvider na implementację w Kotlinie. (I46d4f)
• Dodano funkcję ImageCapture.takePicture suspend, aby można było wywoływać ją w sposób zgodny z językiem Kotlin. (I920BE)

Zmiany interfejsu API

• Dodaj interfejsy API formatu wyjściowego do ImageCapture i metodę getSupportedOutputFormats do ImageCaptureCapabilities, aby zapytać o możliwości urządzenia. Domyślna wartość formatu wyjściowego to OUTPUT_FORMAT_JPEG, która umożliwia rejestrowanie obrazów SDR w formacie JPEG. Jeśli urządzenie obsługuje format ultra HDR, a format wyjściowy jest ustawiony na OUTPUT_FORMAT_JPEG_ULTRA_HDR, CameraX będzie rejestrować skompresowane obrazy w formacie ultra HDR za pomocą formatu JPEG/R. Ten format jest zgodny wstecz z formatem SDR JPEG i obsługuje renderowanie treści w trybie HDR. Oznacza to, że w starszych aplikacjach lub na starszych urządzeniach obrazy będą wyświetlane jako zwykłe JPEG-y, a w aplikacji i na urządzeniu, które zostały zaktualizowane, aby w pełni obsługiwać ten format, będą wyświetlane jako HDR. (I5de50)
• Dodaj PhysicalCameraInfo w CameraInfo, aby zapytać o informacje o fizycznym aparacie, oraz dodaj metodę ustawiania/odczytywania identyfikatora fizycznego aparatu w CameraSelector (Ic5b90).
• Zawartość komórki CameraController#COORDINATE_SYSTEM_VIEW_REFERENCED zastąpiono tekstem ImageAnalysis#COORDINATE_SYSTEM_VIEW_REFERENCED. Wartość stałej pozostaje bez zmian. Dzięki temu wszystkie stałe są konsolidowane w jednym miejscu. (I890bb)
• Nowy interfejs API RetryPolicy umożliwia deweloperom dostosowywanie zachowania ponownego próby w przypadku inicjalizacji CameraX. (I36dd2)
• Włącz tworzenie obiektu ImageCaptureLatencyEstimate, aby ułatwić testowanie (Iaba99)
• Dodaj ImageAnalysis#COORDINATE_SYSTEM_SENSOR. W takim przypadku funkcja MlKitAnalyzer zwraca współrzędne w systemie współrzędnych czujnika aparatu. (I3ec61)
• Interfejs API metadanych rozszerzeń. Nowe interfejsy CameraExtensionsInfo i CameraExtensionsControl umożliwiają aplikacjom monitorowanie i dostosowywanie ustawień siły rozszerzeń. Aplikacje mogą uzyskać instancję CameraExtensionsInfo lub CameraExtensionsControl za pomocą nowo dodanych metod ExtensionsManager#getCameraExtensionsInfo() lub ExtensionsManager#getCameraExtensionsControl(). (I28e1a)
• Dodano wersję ProcessCameraProvider.awaitInstance, która jest wersją zawieszoną wersji ProcessCameraProvider.getInstance (Ib22b9).
• Dodaj interfejs API PreviewView#getSensorToViewTransform(). Macierz ta reprezentuje transformację z współrzędnych czujnika aparatu na współrzędne PreviewView. Można go użyć do przekształcenia współrzędnych z jednego UseCase na inne. Na przykład przekształcenie współrzędnych wykrytych obiektów w ImageAnalysis na nakładkę PreviewView. (I947ab)
• Uczynić interfejs API camera-viewfinder-core bardziej uniwersalnym, aby można było go używać w przypadku camera-viewfinder i camera-viewfinder-compose. (I1e295).
• Dodaj funkcję getSurface do ViewfinderSurfaceRequest. (I781a0)
• Użyj właściwości camera-viewfinder-core w elementach camera-viewfinder i wycofaj elementy ViewfinderSurfaceRequest i CameraViewfinder. (I6198c)
• Dodano interfejs ZoomGestureDetector, który interpretuje gesty skalowania skonfigurowane specjalnie na potrzeby ściągnięcia palców. (Ifafbf)

Poprawki błędów

• Rozwiązaliśmy problem z wybieraniem rozdzielczości ImageAnalysis związany z ustawieniem domyślnej rozdzielczości docelowej analizatora: docelową rozdzielczość nieprawidłowo ustawiano na 640 x 480, nawet jeśli aplikacja miała ustawioną inną domyślną rozdzielczość analizatora. Jeśli aplikacje napotykają ten problem (1.3.0 do 1.3.2) i nie mogą przejść na nowsze wersje, które zawierają rozwiązanie, możesz obejść ten problem, ustawiając bezpośrednio ResolutionSelector z preferowanym rozdzielczością i dopasowując AspectRatioStrategy do ImageAnalysis UseCase. (I81f72, b/330091012)
• Rozwiązaliśmy problem, który powodował, że żądanie takePicture w kolejce mogło się nie uruchomić, jeśli bieżące żądanie zakończyło się niepowodzeniem. (Ie0801)
• Wprowadzić sprawdzanie nieprawidłowych danych JPEG na urządzeniach Vivo X60 i X60 Pro. Może to rozwiązać problem z nieprawidłowo dużymi obrazami na tych urządzeniach. (I82247, b/288828159)
• Naprawiono problem z nieprawidłowymi metadanymi obrazu JPEG na urządzeniach Samsung A24. Po wprowadzeniu poprawki CameraX może zapisać obraz JPEG lub zwracać prawidłowe obiekty Bitmap podczas wywołania funkcji ImageProxy.toBitmap() na urządzeniach Samsung A24. (I8d6eb, b/309005680)
• Jeśli przechwycony obraz jest większy niż 10 MB, zastosuj nieprawidłowe sprawdzanie danych JPEG na wszystkich urządzeniach Samsung. Może to rozwiązać problem z nieprawidłowo dużymi obrazami na urządzeniach Samsung. (Ic2a65, b/288828159)
• Usunięto obsługę ImageAnalysis w rozszerzeniach CameraX, ponieważ wiele implementacji rozszerzeń przez producentów nie działa dobrze z ImageAnalysis i może powodować niespójności. (I2d926)

Wersja 1.4.0-alpha04

24 stycznia 2024 r.

androidx.camera:camera-*:1.4.0-alpha04 został zwolniony. Wersja 1.4.0-alpha04 zawiera te commity.

Nowe funkcje

• Nowy artefakt: camera-effects: biblioteka do stosowania efektów w czasie rzeczywistym do danych wyjściowych CameraX, w tym Preview, VideoCapture lub ImageCapture. Ten element zawiera implementacje interfejsu API CameraEffect w OpenGL, który efektywnie manipuluje wyjściem z kamery.
• OverlayEffect: do rysowania nakładek za pomocą interfejsu Canvas API na Androida. Dzięki temu aplikacja może stosować znak wodny lub wyróżniać wykryte obiekty na obrazie z kamery.
• DynamicRange Interfejsy API do stosowania w przypadku podglądu: zakres dynamiczny można teraz ustawić w przypadku użycia w ramach podglądu niezależnie od przypadku użycia w ramach filmu. Umożliwia to stosowanie dynamicznych zakresów HDR, takich jak HLG10, tylko w przypadku podglądu. W CameraInfo dostępne są też nowe interfejsy API, które umożliwiają zapytanie o zakresy dynamiczne obsługiwane przez poszczególne kamery.

Zmiany w interfejsie API

• Zmieniono nazwę parametru ScreenFlashUiCompleter na ScreenFlashListener i przeniesiony parametr ScreenFlashUiCompleter#getExpirationTimeMillis do parametru expirationTimeMillis w kampanii ScreenFlash#apply. (I13944)
• Dodano nowe interfejsy API, które umożliwiają ustawianie zakresu dynamicznego w przypadku użycia podglądu oraz przesyłanie zapytań dotyczących zakresów dynamicznych obsługiwanych przez dany aparat. Dzięki temu zakresy dynamiczne HDR, takie jak HLG10, mogą być używane tylko w przypadku podglądu, bez konieczności jednoczesnego wiązania VideoCapture. (If25e3)
• Nazwa getMirroring() została zmieniona na isMirroring() (I47063).
• Dodano obsługę szacowania opóźnienia w ramce w aplikacji CameraX. Rozszerzenia aparatu umożliwiają aplikacjom korzystanie z interfejsu API, który szacuje czas wykonania przechwycenia. Oszacowanie uwzględnia bieżące warunki środowiska i stan kamery, a także czas przetwarzania żądań przechwytywania wielu klatek oraz w razie potrzeby dodatkowy czas na kodowanie przetworzonych buforów. (I05c3a)
• Nazwa ScreenFlashUiControl została zmieniona na ScreenFlash, ScreenFlashUiControl#applyScreenFlashUi na ScreenFlash#apply, ScreenFlashUiControl#clearScreenFlashUi na ScreenFlash#clear, a zamiast bezpośredniego udostępniania metody SCREEN_FLASH_UI_APPLY_TIMEOUT_SECONDS dodano metodę getScreenFlashUiApplyTimeoutSeconds. (Iccdd0)

Poprawki błędów

• Rozwiązaliśmy wyciek pamięci, który powodował, że działania lub fragmenty nie były zwalniane przy włączonym rozszerzeniach (I14215)
• Rozwiązaliśmy problem polegający na tym, że funkcja getZoomRatio zwracała nieprawidłowo zmniejszoną wartość podczas stosowania zwiększonego współczynnika powiększenia. (I4aa0d, b/317543616)
• Zdarzenie ImageCapture#ScreenFlash#clear jest wywoływane natychmiast, gdy ImageCapture jest odłączony lub gdy kamera jest zamknięta. Rozwiązano też niektóre błędy, w których to zdarzenie nie było nigdy wywoływane, ponieważ w tych scenariuszach nie było prawidłowo wykonywane. (If99f9)
• Rozwiązaliśmy problem z zawieszaniem się aplikacji, który występował, gdy cykl życia został zatrzymany przed zakończeniem żądania takePicture (Idf017, b/306202751).
• Rozwiązaliśmy problem, który powodował, że na niektórych urządzeniach podgląd z aparatu był czarny (I1ffd0)
• Naprawiono nieprawidłowy czas trwania nagrywania filmów na urządzeniach z procesorem Snapdragon 778G SoC (If6aa7, b/316057919).

Wersja 1.4.0-alpha03

13 grudnia 2023 r.

androidx.camera:camera-*:1.4.0-alpha03 został zwolniony. Wersja 1.4.0-alpha03 zawiera te commity.

Nowe funkcje

• Dodano CameraInfo.mustPlayShutterSound, aby podać informacje o tym, czy dźwięk migawki musi być odtwarzany zgodnie z ograniczeniami regionalnymi. (Ifda84)
• Dodano OnImageCapturedCallback.onCaptureStarted i OnImageSavedCallback.onCaptureStarted, aby powiadomić, kiedy kamera zaczęła naświetlać kadr. W tym momencie zalecamy odtworzenie dźwięku migawki lub animacji migawki. (IC49b3).
• Dodaliśmy obsługę funkcji błysku ekranu w aplikacji CameraX do robienia zdjęć za pomocą przedniego aparatu. CameraX zajmie się obsługą interfejsu API po stronie platformy i w razie potrzeby zsynchronizuje czas ze zmianami w interfejsie aplikacji (np. aktywuje wstępne robienie zdjęć z efektem AE po zmianie koloru lub jasności ekranu aplikacji). Aplikacje muszą tylko dodać implementacje interfejsu użytkownika w interfejsie ScreenFlashUiControl udostępnionym przez CameraX. (I8ae84)
• Dodano obsługę implementacji funkcji Błysk na ekranie w interfejsie API CameraX. Aplikacje będą mogły korzystać z podstawowej implementacji ImageCapture.ScreenFlashUiControl z poziomu PreviewView lub z nowego ScreenFlashView, który doda widok monochromatycznej nakładki i zmaksymalizuje jasność ekranu podczas robienia zdjęcia z błyskiem ekranu. (I1810e)

Zmiany w interfejsie API

• Obsługa nowych funkcji rozszerzeń(postęp procesu po wyświetleniu i rejestrowaniu): dodano interfejsy API ImageCapture#getImageCaptureCapabilities() dla aplikacji, aby umożliwić w przypadku zapytań o możliwości wywołania zwrotnego postępu procesu po wyświetleniu i rejestracji. Aplikacje mogą włączyć postview za pomocą ImageCapture.Builder#setPostviewEnabled(). Rozmiar po wyświetleniu można wybrać za pomocą parametru ImageCapture.Builder#setPostviewResolutionSelector(). Podczas wywoływania takePicture() można zaimplementować onPostviewBitmapAvailable i onCaptureProcessProgressed w OnImageSavedCallback lub OnImageCapturedCallback, aby uzyskać powiadomienie o wyświetleniu reklamy i przetworzyć powiadomienie o postępach (jeśli jest obsługiwane). (I5cd88)
• Interfejsy API do obliczania transformacji współrzędnych z czujnika do bieżącego bufora z flagą wskazującą, czy Surface zawiera informacje o orientacji kamery (I59096).
• Udostępnij interfejs API, aby wysłać zapytanie PreviewCapabitlity w wersji testowej UseCase. (IE5b6c)
• Dodano interfejsy API, aby obsługiwać więcej jakości w przypadku VideoCapture. Recorder.Builder#setVideoCapabilitiesSource(int) może być użyte z VIDEO_CAPABILITIES_SOURCE_CODEC_CAPABILITIES do utworzenia Recorderinstancji, która obsługuje więcej jakości niż VIDEO_CAPABILITIES_SOURCE_CAMCORDER_PROFILE. Typowym przypadkiem jest sytuacja, gdy aplikacja stara się nagrywać filmy w jakości UHD, ale CamcorderProfile urządzenia nie zawiera ustawień UHD, mimo że kodek umożliwia nagrywanie filmów w tej jakości. (Iedbe2, b/263961771)
• Dodano metodę pobierania/usuwania formatu wyjściowego ImageAnalysis do elementu CameraController. (I9a96c, b/308240643)

Poprawki błędów

• W sekcji Aparat 1.3.1: ulepszono działanie ProcessCameraProvider#bindToLifecycle(). Główna zmiana polega na optymalizacji procesu identyfikowania najbardziej odpowiednich kombinacji rozmiarów w przypadku elementu UseCases. Optymalne wyniki zależą od konkretnych kombinacji UseCase i liczby obsługiwanych rozmiarów wyjściowych na urządzeniach docelowych. (I454f2)
• Zezwalaj na używanie VideoCapture, gdy włączone są rozszerzenia. (I91f32)
• Rozwiązano problem z dużymi obrazami JPEG na urządzeniach z serii Samsung A71 i M51. Przechwycone obrazy JPEG zawierają zbędne dane dopełnienia 0 w segmencie danych skompresowanych JFIF. Zbyt duże rozmiary plików na przechwyconych zdjęciach. Te zbędne dane wypełniające z zerami zostaną usunięte, aby zarejestrowane obrazy miały normalny rozmiar pliku. (I01afc, b/288828159)
• Wyłącz obsługę ImageAnalysis na Pixelach, aby uniknąć błędu, który powoduje przypadkowe zwracanie niepustych obsługiwanych rozmiarów ImageAnalysis. (I7ec31)
• Rozwiązaliśmy problem z wydajnością, który powodował wzrost obciążenia procesora i zużyciem energii, gdy włączone były rozszerzenia. (Ibdccb)
• Dodano Snapdragona 480 do listy CameraUseInconsistentTimebaseQuirk. Rozwiązano problem z Androidem 12 na urządzeniach z tym chipsetem, na których dźwięk w nagraniach jest przesunięty o czas, przez jaki urządzenie było w stanie zawieszenia. (I58010)

Wersja 1.4.0-alpha02

18 października 2023 r.

androidx.camera:camera-*:1.4.0-alpha02 został zwolniony. Wersja 1.4.0-alfa02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Zmień nazwę interfejsu API na setCameraOpenRetryMaxTimeoutInMillisWhileResuming i nazwę argumentu. (I72370)
• Dodano interfejsy API do zapytania o możliwości urządzenia i włączenie stabilizacji obrazu w filmie i podglądzie. (I87544)
• Udostępnij interfejs API, aby dostosować maksymalny czas oczekiwania na ponowne otwarcie aparatu. (I0c642)
• Udostępniliśmy interfejs ProcessCameraProvider.shutdownAsync jako publiczny interfejs API do testowania, aby umożliwić korzystanie z procesu dostawcy aparatu w pakietach testów, które mogą wymagać inicjowania CameraX na różne sposoby w międzyczasie testów. (I9eca7)
• Dodaj interfejsy API do konfigurowania zakresu dynamicznego, częstotliwości klatek i trybu lustrzanego podczas rejestrowania filmów. (Ifb8f7).
• Wycofaj OutputSize i zastąp go ResolutionSelector. ResolutionSelector to bardziej wszechstronny sposób wyboru rozdzielczości, zgodny z interfejsem Camera Core API. (I93abd, b/286801438)

Poprawki błędów

• Rozwiązaliśmy problem z czarnym podglądem na telefonie Samsung Galaxy S23 Ultra 5G, gdy w tylnym aparacie włączono rozszerzenia Bokeh lub retusz twarzy przy użyciu funkcji ImageAnalysis. (I2e8b1).
• Naprawiliśmy problemy z podglądem i problemy z rozciągniętym opóźnieniem (VideoCapture) w Moto E5 Play. (73dce2)

Wersja 1.4.0-alpha01

20 września 2023 r.

androidx.camera:camera-*:1.4.0-alpha01 został zwolniony. Wersja 1.4.0-alpha01 zawiera te commity.

Zmiany w interfejsie API

• Dodaj nowy interfejs API, aby uzyskać dostęp do informacji o amplitudzie dźwięku podczas nagrywania. (Id4925).

Poprawki błędów

• Zwiększ stabilność rozszerzeń, dbając o to, aby zdarzenia inicjalizacji i dezincjalizowania były wywoływane we właściwej kolejności. (Ib3b8e)
• Rozwiązaliśmy problem z błędem konfiguracji sesji przechwytywania spowodowanym przez przekroczenie kombinacji obsługiwanej powierzchni z powodu wewnętrznego dodania dodatkowej powtarzającej się powierzchni. (Id718c)
• Usunięto problem z dużymi obrazami JPEG na urządzeniu Vivo S16. Zdjęcia JPEG zawierają w segmencie danych skompresowanych JFIF niepotrzebne dane wypełniające z zerami. Zdjęcia mają wtedy duży rozmiar. Te zbędne dane wypełniające z zerami zostaną usunięte, aby zarejestrowane obrazy miały normalny rozmiar pliku. (I79505, b/299069235)
• Rozwiązanie problemu polegającego na tym, że ImageAnalysis nie może być powiązany z ImageCapture i Podglądem, gdy niektóre tryby rozszerzenia są włączone na niektórych urządzeniach. Rozwiązanie problemu zwróci prawidłową wartość, gdy aplikacje będą wysyłać zapytania o dostępność: ImageAnalysis za pomocą: ExtensionsManager#isImageAnalysisSupported(). (I7d538)
• Zaktualizuj JavaDoc, aby pasował do zachowania. Zamiast natychmiastowego zakończenia #setZoomRatio, #setLinearZoom i #enableTorch czekają, aż kamera będzie gotowa. Dodano też informacje o tym, jak uzyskać maksymalne pole widzenia za pomocą interfejsu API #takePicture. (I23588)

Wersja 1.3

Wersja 1.3.4

12 czerwca 2024 r.

androidx.camera:camera-*:1.3.4 został zwolniony. Wersja 1.3.4 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że funkcja getZoomRatio nieprawidłowo zwracała zmniejszoną wartość po zastosowaniu rosnącego współczynnika powiększenia. (I4aa0d, b/317543616)
• Naprawiono problem z robieniem zdjęć/naciskiem do ustawienia ostrości, który nie korzysta z wartości powtarzających się żądań FPS/trybu stabilizacji, co może powodować ponowne tworzenie sesji rejestrowania i problemy z opóźnieniem lub zacinanie się podglądu na niektórych urządzeniach. (I7dc0b)
• Rozwiązaliśmy problem, który powodował, że podczas wywoływania funkcji setTargetFrameRate za pomocą funkcji FRAME_RATE_RANGE_UNSPECIFIED ustawiana jest niższa liczba klatek na sekundę. (I78c61)

Wersja 1.3.3

17 kwietnia 2024 r.

androidx.camera:camera-*:1.3.3 został zwolniony. Wersja 1.3.3 zawiera te komity.

Poprawki błędów

• Rozwiązaliśmy problem z wybieraniem rozdzielczości ImageAnalysis związany z ustawieniem domyślnej rozdzielczości docelowej analizatora: docelową rozdzielczość nieprawidłowo ustawiano na 640 x 480, nawet jeśli aplikacja miała ustawioną inną domyślną rozdzielczość analizatora. Jeśli aplikacje napotykają ten problem (1.3.0 ~ 1.3.2) i nie mogą przejść na nowsze wersje, które zawierają rozwiązanie, możesz obejść ten problem, ustawiając bezpośrednio ResolutionSelector z preferowanym rozdzielczością i odpowiadającym AspectRatioStrategy do przypadku użycia ImageAnalysis. (I81f72, b/330091012)

Wersja 1.3.2

6 marca 2024 roku

androidx.camera:camera-*:1.3.2 został zwolniony. Wersja 1.3.2 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem z metadanymi JPEG-a na urządzeniach Samsung A24. AparatX dokładnie zapisuje obrazy, a funkcja ImageProxy.toBitmap() zwraca prawidłowe obiekty mapy bitowej. (I8d6eb, b/309005680)
• Usunięto opcję rozdzielczości 9280 x 6944 na urządzeniach Redmi Note 9 Pro ze względu na problemy. (Ia23da)

Wersja 1.3.1

13 grudnia 2023 r.

androidx.camera:camera-*:1.3.1 został zwolniony. Wersja 1.3.1 zawiera te zatwierdzenia.

Poprawki błędów

Poprawiono wydajność ProcessCameraProvider#bindToLifecycle(). Główną zmianą jest optymalizacja procesu identyfikowania najbardziej odpowiednich kombinacji rozmiarów dla UseCases. Optymalne wyniki zależą od konkretnych kombinacji UseCase i liczby obsługiwanych rozmiarów wyjściowych na urządzeniach docelowych. (I454f2)

Oto kilka przykładowych wyników w różnych sytuacjach:

• 4 UseCases: Preview + ImageCapture + ImageAnalysis + VideoCapture

  • Google Pixel 7: od 430 ms do 60 ms
  • Samsung Galaxy S23 Ultra: ok. 540–45 ms
  • Samsung A53 5G: około 115–70 ms

• 3 UseCases: Preview + ImageCapture + ImageAnalysis

  • Google Pixel 7: ok. 9 ms–7 ms
  • Samsung Galaxy S23 Ultra: ok. 6 ms do 5 ms
  • Samsung A53 5G: około 32 ms do 12 ms

• Dodano Snapdragona 480 do listy CameraUseInconsistentTimebaseQuirk. Rozwiązano problem z Androidem 12 na urządzeniach z tym chipsetem, na których dźwięk w nagraniach jest przesunięty o czas, przez który urządzenie było w stanie zawieszenia. (I58010)

Wersja 1.3.0

18 października 2023 r.

Usługa androidx.camera:camera-*:1.3.0 została zwolniona. Wersja 1.3.0 zawiera te commity.

Ważne zmiany od wersji 1.2.0

• Funkcje wideo, w tym 10-bitowy HDR, przycinanie, odbicie lustrzane/bez odbicia lustrzanego, wyciszanie/wyłączanie wyciszenia, ustawianie liczby klatek i inne.
• Podwójny aparat
• Biblioteka efektów
• Selektor rozdzielczości
• Wybór aparatu ultraszerokokątnego i teleobiektywu
• Przełączanie aparatów podczas nagrywania wideo (funkcja eksperymentalna)

Wersja 1.3.0-rc02

20 września 2023 r.

androidx.camera:camera-*:1.3.0-rc02 został zwolniony. Wersja 1.3.0-rc02 zawiera te commity.

Poprawki błędów

• Zwiększ stabilność rozszerzeń, dbając o to, aby zdarzenia inicjalizacji i dezincjalizowania były wywoływane we właściwej kolejności. Rozwiązaliśmy problemy z czarnym podglądem podczas przełączania trybów rozszerzeń lub kamer. (Iddaac)
• Rozwiązanie problemu polegającego na tym, że ImageAnalysis nie może być powiązany z ImageCapture i Podglądem, gdy niektóre tryby rozszerzenia są włączone na niektórych urządzeniach. Poprawka spowoduje zwrócenie prawidłowej wartości, gdy aplikacje zapytają o dostępność ImageAnalysis za pomocą ExtensionsManager#isImageAnalysisSupported(). (I7d538)
• Rozwiązaliśmy problem polegający na tym, że dźwięk i obraz nagranego filmu były niezsynchronizowane, gdy włączono tryb lustrzanego odbicia na Xiaomi Poco X3 NFC. (I20b4c)

Wersja 1.3.0-rc01

23 sierpnia 2023 r.

androidx.camera:camera-*:1.3.0-rc01 został zwolniony. Wersja 1.3.0-rc01 zawiera te commity.

Zmiany w interfejsie API

• Dodano PendingRecording.asPersistentRecording, aby umożliwić ciągłe nagrywanie, gdy VideoCapture, do którego jest podłączony Rejestrator, jest ponownie uruchamiany. (I517c6)

Poprawki błędów

• Naprawiono błąd powodujący awarię, gdy strumień był udostępniany zarówno w VideoCapture, jak i w Podglądzie. Naprawiono też czarny ekran na urządzeniach LEGACY po włączeniu udostępniania transmisji.
• Usunięto problem z dużymi obrazami JPEG na urządzeniach z serii Samsung S7 (SM-G930T, SM-G930V). Zdjęcia JPEG zawierają w segmencie danych skompresowanych JFIF niepotrzebne dane wypełniające z zerami. Zdjęcia mają wtedy duży rozmiar. Te zbędne dane wypełniające z zerami zostaną usunięte, aby zarejestrowane obrazy miały normalny rozmiar pliku. (I407b0, b/288828159)
• Usunięto problem z dużym przechwyconym obrazem JPEG na urządzeniach Samsung S22 (SM-S901B, SM-S901B/DS) i S22+ (SM-S906B). Przechwycone obrazy JPEG zawierają nadmiarowe dane dopełnienia 0 w segmencie danych skompresowanych JFIF. Z tego powodu na urządzeniu S22 SM-S901B/DS zrobione zdjęcia mają duży rozmiar około 13 MB. Te zbędne dane wypełniające z zerami zostaną usunięte, aby zarejestrowane obrazy miały normalny rozmiar pliku. (I73be9, b/288828159)
• Rozwiązano problem z dużymi obrazami JPEG na urządzeniach z serii Samsung A5, A52, A70 i A72. Zdjęcia JPEG zawierają w segmencie danych skompresowanych JFIF niepotrzebne dane wypełniające z zerami. Powoduje to, że rozmiary uchwycionych obrazów są bardzo duże (np. 32 MB lub nawet 96 MB). Te zbędne dane wypełniające z zerami zostaną usunięte, aby zarejestrowane obrazy miały normalny rozmiar pliku. (I97c4d, b/288828159)
• Naprawiono problem z wypadkiem aplikacji natywnej podczas robienia zdjęć przy włączonych rozszerzeniach (I698f5)

Wersja 1.3.0-beta02

26 lipca 2023 r.

androidx.camera:camera-*:1.3.0-beta02 został zwolniony. Wersja 1.3.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

• Używanie lampy błyskowej w modelach Pixel 4 i 5, aby poprawić jakość zdjęć w warunkach słabego oświetlenia (I56ff5, b/280221967)
• Rozwiązaliśmy problem z dużym przechwyconym obrazem JPEG na urządzeniach Samsung A5 (2017). Zdjęcia JPEG zawierają w segmencie danych skompresowanych JFIF niepotrzebne dane wypełniające z zerami. Zdjęcia mają wtedy rozmiar około 32 MB. Zbędne dane dopełnienia 0 zostaną usunięte, aby zrobione zdjęcia miały prawidłowy rozmiar. (I29837, b/288828159)
• Rozwiązano problem z nieprawidłowym uruchamianiem ponownego próby w przypadku niepowodzenia rejestrowania na problemowych urządzeniach wymienionych w artykule CaptureFailedRetryQuirk. (I7B589)

Wersja 1.3.0-beta01

21 czerwca 2023 r.

Usługa androidx.camera:camera-*:1.3.0-beta01 została zwolniona. Wersja 1.3.0-beta01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Zmieniliśmy nazwę funkcji ResolutionSelector.Builder#setHighResolutionEnabledFlag(int) na setAllowedResolutionMode, a stałe ResolutionSelector#HIGH_RESOLUTION_FLAG_OFF/ON na PREFER_CAPTURE_RATE_OVER_HIGHER_RESOLUTION/PREFER_HIGHER_RESOLUTION_OVER_CAPTURE_RATE (If84e8).
• Usunięto wycofane interfejsy API: ImageAnalysis.setTargetRotationDegrees(int), ImageCapture.setTargetRotationDegrees(int) i VideoCapture.setTargetRotationDegrees(int). (Id8e77)
• Klasa DynamicRange reprezentuje dynamiczny zakres obrazów. Można go użyć do wybrania formatów High Dynamic Range jako wyjścia VideoCapture do VideoCapture.Builder#setDynamicRange(). (Ib0377)
• Dodano interfejs API isImageAnalysisSupported do ExtensionsManager, dzięki któremu aplikacje mogą określić, czy przypadki użycia ImageAnalysis można powiązać z podglądem i ImageCapture, gdy są włączone rozszerzenia. (I1bc63)
• Nowa klasa VideoCapabilities uzyskana z Recorder może być używana do wysyłania zapytań dotyczących obsługiwanych zakresów dynamicznych i jakości nagrywania wideo na urządzeniu. Metody QualitySelector getSupportedQualities() i isQualitySupported() są wycofywane. Zamiast niego użyj metod getSupportedQualities() i isQualitySupported() interfejsu VideoCapabilities. (I04014)
• Nazwa CameraController#setVideoCaptureTargetQuality() została zmieniona na setVideoCaptureQualitySelector i przyjmuje argument QualitySelector, co zapewnia większą elastyczność konfigurowania jakości wideo. Wartość CameraController#getVideoCaptureTargetQuality() została odpowiednio zmieniona na getVideoCaptureQualitySelector. (I520ed)
• Usunęliśmy eksperymentalną adnotację dotyczącą funkcji wideo. Funkcje wideo są teraz stabilne. (I1a113)

Poprawki błędów

• Użyj latarki jako lampy błyskowej na modelach Samsung SM-A320, aby zwiększyć szybkość i jakość zdjęć w słabym oświetleniu. (I6a022, b/286190938)
• Dodaliśmy obsługę formatu ImageFormat.JPEG dla ImageProxy.toBitmap(). Jeśli nie uda się zdekodować tablicy bajtów JPEG, zostanie wywołana funkcja UnsupportedOperationException. (I81958, b/282057603)

Wersja 1.3.0-alpha07

24 maja 2023 r.

androidx.camera:camera-*:1.3.0-alpha07 został zwolniony. Wersja 1.3.0-alpha07 zawiera te commity.

Nowe funkcje

• Nowy interfejs API VideoCapture.Builder# setTargetFrameRate(Range) umożliwia rejestrowanie filmów z inną częstotliwością klatek niż domyślna częstotliwość klatek urządzenia. Dostępne częstotliwości klatek dla nagrań można sprawdzić za pomocą nowego interfejsu API CameraInfo#getSupportedFrameRates().

Zmiany interfejsu API

• Zmieniono nazwy stałych ResolutionSelector#HIGH_RESOLUTION_FLAG_OFF i ON na ALLOWED_RESOLUTIONS_NORMAL i SLOW oraz nazwę funkcji konstruktora setHighResolutionEnabledFlag na setAllowedResolutionMode. (Iae817)
• Funkcja CameraInfo#getSupportedFrameRateRanges() zwraca teraz wartość Set, a nie List, aby lepiej odzwierciedlać fakt, że zakresy nie są uporządkowane. (I02f43)
• Dodaj do CameraEffect obiekt ErrorListener, aby obsługiwać nieodwracalne błędy (Ice471).
• Dodaj publiczny konstruktor w ResolutionInfo, aby ułatwić testowanie (If6d1c)
• Udostępniliśmy interfejs API UseCase.snapToSurfaceRotation(int), aby zastąpić używanie setTargetRotationDegrees i wycofać interfejsy API ImageAnalysis.setTargetRotationDegrees(int), ImageCapture.setTargetRotationDegrees(int) i VideoCapture.setTargetRotationDegrees(int). (Ia9010)
• Dodano nowe interfejsy API Preview#getTargetFrameRate i Preview.Builder#setTargetFrameRate, aby umożliwić ustawianie i pobieranie docelowej liczby klatek w przypadku użycia podglądu (If4f2).
• Funkcja VideoRecordEvent.Finalize zostanie teraz zakończona z kodem błędu ERROR_RECORDING_GARBAGE_COLLECTED, gdy obiekt Recording zostanie zatrzymany z powodu zbierania elementów usuniętych z pamięci. (Iba974)

Poprawki błędów

• Naprawiono NullPointerException, gdy rozmiary danych wyjściowych z pamięci podręcznej w zasadzie StreamConfigurationMapCompat mają wartość null. (Idf124, b/282025204)
• Rozwiązaliśmy problem, który powodował, że Preview.setSurfaceProvider(null) nie wstrzymywał podglądu w rozszerzeniach (Ia903e).
• Rozwiązaliśmy problem polegający na tym, że podczas otwierania aparatu ConcurrentModificationException jest rzucany, gdy VideoCapture jest powiązany. (Ic8ac4)

Wersja 1.3.0-alpha06

19 kwietnia 2023 r.

androidx.camera:camera-*:1.3.0-alpha06 został zwolniony. Wersja 1.3.0-alpha06 zawiera te commity.

Nowe funkcje

• Równoległy aparat to nowa funkcja wprowadzona w Androidzie 11, która obsługuje jednoczesne przesyłanie strumieniowe z urządzeń z kamerą, np. umożliwia jednoczesne korzystanie z przedniego i tylnego aparatu. CameraX obsługuje obecnie tylko podwójne kamery równoczesne, co umożliwia jednoczesne działanie dwóch kamer, do których przypisano maksymalnie dwie {@link UseCase} dla każdej z nich. Maksymalna rozdzielczość to 720p lub 1440p. Więcej informacji znajdziesz pod tym linkiem: CameraManager#getConcurrentCameraIds()
• Przedstawiamy nowy interfejs API ResolutionSelector, który obejmuje te funkcje:
  • Aplikacje mogą określać format obrazu i strategie dotyczące rozdzielczości, aby wybrać najlepszą rozdzielczość dla swoich potrzeb.
  • Wszystkie rozmiary i parametry proporcji są wyrażane w współrzędnych czujnika urządzenia.
  • Aplikacje mogą stosować niestandardowy filtr rozdzielczości, aby ustawić obsługiwane rozmiary w pożądanej kolejności.
  • Aplikacje mogą też umożliwiać rejestrowanie zdjęć w wysokiej rozdzielczości. Pamiętaj jednak, że używanie wysokiej rozdzielczości może wydłużyć czas nagrywania.
  • Dodano interfejsy API powielania VideoCapture. Domyślnie filmy nagrane przez użytkownika VideoCapture nie są powielane. Jednak w przypadku przedniego aparatu podgląd jest domyślnie odbity jak w lustrze. Interfejsy API do tworzenia odbicia lustrzanego VideoCapture umożliwiają dopasowanie do podglądu z aparatu podczas używania przedniego aparatu. Tak nazywają się 3 osoby: MirrorMode, OFF, ON i ON_FRONT_ONLY. Aby dopasować obraz do podglądu w aparacie, zalecamy użycie opcji ON_FRONT_ONLY, co oznacza, że lustro nie jest włączone w przypadku tylnego aparatu, ale jest włączone w przypadku przedniego aparatu.

Zmiany w interfejsie API

• Udostępniliśmy nowy interfejs API ResolutionSelector. Aplikacje mogą określać strategie dotyczące formatu obrazu i rozdzielczości za pomocą reguł zapasowych lub niestandardowego filtra rozdzielczości, aby uzyskać pożądane wyniki. Aplikacje mogą określać flagę, aby umożliwić rejestrowanie w wysokiej rozdzielczości. Dzięki temu CameraX będzie mogło wybierać wyższe rozdzielczości podczas robienia zdjęć lub nagrywania filmów. Pamiętaj jednak, że używanie wysokiej rozdzielczości może wydłużyć czas nagrywania. (Ibed95)
• Zakresy liczby klatek na sekundę obsługiwane przez algorytm AE można teraz wyszukiwać za pomocą zapytania CameraInfo#getSupportedFrameRateRanges(). (Iaa67f)
• Połącz nazwy wszystkich metod dotyczących częstotliwości klatek, używając parametru „FrameRate”. Popraw błąd w pliku javadoc w VideoCapture#getTargetFrameRate() (I83304)
• Wycofano starsze interfejsy API setTargetAspectRatio i setTargetResolution. Zamiast tego użyj nowego interfejsu API ResolutionSelector. (I542c3)
• Dodano publiczne interfejsy API do obsługi równoczesnego korzystania z podwójnego aparatu, w tym:
  1. List<List<CameraInfo>> getAvailableConcurrentCameraInfos()
  2. ConcurrentCamera bindToLifecycle(@NonNull ConcurrentCameraConfig concurrentCameraConfig)
  3. boolean isConcurrentCameraModeOn() i ConcurrentCameraConfig, SingleCameraConfig i ConcurrentCamera (Iab1c1)
• Ustaw ImageProcessor.Response#getOutputImage na NonNull (Ib9c60).
• Dodano interfejsy API do powielania VideoCapture, w tym VideoCapture.Builder.setMirrorMode(int) i VideoCapture.getMirrorMode(). Interfejsy API są przydatne w aplikacjach, które wymagają, aby nagrywanie wideo było zgodne z typowym sposobem działania podglądu aparatem, np. podgląd z tylnego aparatu nie jest odbiciem lustrzanym, ale podgląd z przedniego aparatu jest odbiciem lustrzanym. (I713b6, b/194634656)
• Dodanie interfejsu setTargetFrameRate() w interfejsie VideoCapture.Builder oraz interfejsu getTargetFramerate() w interfejsie VideoCapture (I109d4)
• Ustaw rozszerzenie SurfaceOutput na zamykanie i ukryj publiczny konstruktor SurfaceOutput.Event. (I60ea8)
• Dodano Recording.mute, aby dynamicznie wyciszyć lub włączyć wyciszenie nagrania w trakcie przetwarzania. RecordingStats będzie zawierać AudioStats.AUDIO_STATE_MUTED, gdy w trakcie przetwarzania nagranie jest wyciszone. (Ie17fc)
• Parametr #setEffects() nie może być równy null. Dodano interfejs API #clearEffects() do anulowania efektów. Aplikacja powinna wywołać funkcję #clearEffects(), aby usunąć efekty. (I4b4d9)
• Dodaj drugi konstruktor dla ViewfinderSurfaceRequest.Builder, aby użyć kreatora do konstruktora tekstu (I621a7)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował awarię aplikacji wywołujących Extensions API podczas zamykania aparatu (Ib27e5).
• Rozwiązaliśmy problem, który powodował, że aplikacja VideoCapture nie działała z przednią kamerą na niektórych urządzeniach. Na przykład na telefonie Samsung Galaxy S23 i Xiaomi 2107113SG. (Ibec7e, b/270656244)
• Rozwiązanie problemu polegającego na tym, że robienie zdjęć za pomocą aplikacji Pliki w folderze publicznym na zewnętrznym urządzeniu pamięci zawsze kończyło się niepowodzeniem w Androidzie 10 lub nowszym. Pamiętaj, że na Androidzie 10 robienie zdjęć przy użyciu opcji Plik w publicznym folderze pamięci zewnętrznej wymaga też ustawienia requestLegacyExternalStorage w tagu aplikacji. (I11b2c)
• Naprawiono błąd RejectedExecutionException w funkcji DefaultSurfaceProcessor. Awaria może wystąpić, gdy VideoCapture jest powiązany, a aktywność jest wstrzymana. (Idb46a, b/273713906)

Wersja 1.3.0-alpha05

22 marca 2023 r.

Usługa androidx.camera:camera-*:1.3.0-alpha05 została zwolniona. Wersja 1.3.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

• Dodano interfejsy API rotacji VideoCapture, w tym VideoCapture.Builder.setTargetRotation(int), VideoCapture.setTargetRotation(int), VideoCapture.setTargetRotationDegrees(int) i VideoCapture.getTargetRotation(). Interfejsy API są przydatne w przypadku aplikacji, które blokują orientację urządzenia. Dodano też użytkowników ImageCapture.setTargetRotationDegrees(int) i ImageAnalysis.setTargetRotationDegrees(int). (Id3ffe, b/205242781)
• Zezwalaj na docelowe efekty: VIDEO_CAPTURE i PREVIEW|VIDEO_CAPTURE. Efekty kierowane na VIDEO_CAPTURE będą stosowane w przypadku użycia modelu VideoCapture. Efekty kierowane na kanał PREVIEW|VIDEO_CAPTURE zostaną zastosowane do udostępnionego strumienia przed skopiowaniem go do strumienia podglądu i VideoCapture. (Iee6f3).

Poprawki błędów

• Aparat1.2.2: rozwiązaliśmy problem, który powodował, że rozszerzenia CameraX nie działały prawidłowo, gdy włączono ProGuard na niektórych urządzeniach, takich jak Pixel (I90aa2).
• Usunęliśmy błąd PreviewView, który powodował, że jeśli aplikacja sama obsługuje orientację ekranu, podgląd mógł zostać zniekształcony po obróceniu. Dzieje się tak tylko na niektórych urządzeniach. Można ją odtworzyć na Pixelu a4, Pixelu 5 i Pixelu 6a. (I14340, b/223488673)

Wersja 1.3.0-alpha04

22 lutego 2023 roku

androidx.camera:camera-*:1.3.0-alpha04 został zwolniony. Wersja 1.3.0-alpha04 zawiera te commity.

Nowe funkcje

Nowa funkcja obsługi nieobsługiwanych wcześniej kombinacji powierzchni poprzez udostępnianie jednego strumienia wielu zastosowaniom.

• Wcześniej podczas wiązania „Preview, VideoCapture, ImageAnalysis” na poziomie sprzętu aparatu FULL i niżej lub wiązania „Preview, VideoCapture, ImageCapture” na poziomie sprzętu LEGACY, CameraX wyrzuca IllegalArgumentException.
• Nowe zachowanie polega na tym, że powiązania będą działać bez zgłaszania wyjątków. Zamiast tego CameraX używa OpenGL do kopiowania udostępnionego strumienia do podglądu i VideoCapture.
• W efekcie może to spowodować wzrost opóźnienia i zużycia energii.

Zmiany w interfejsie API

• Dodaj interfejs API, aby przekonwertować ImageProxy na Bitmap. Obsługiwany format elementu ImageProxy to ImageFormat.YUV_420_888 i PixelFormat.RGBA_8888. Jeśli format jest nieprawidłowy, zostanie zwrócony błąd IllegalArgumentException. (Ic7110)
• Dodaj CoroutineCameraViewfinder, aby umożliwić konfigurowanie wizjera za pomocą funkcji zawieszania w Kotlinie. (I657bc)
• Dodaj nowy publiczny konstruktor klasy ViewfinderSurfaceRequest. Zapewnia elastyczność, gdy użytkownik nie może podać CameraCharacteristics. (IE6549)

Poprawki błędów

• Naprawiono problem z zawieszaniem się rozszerzeń, który występuje na niektórych urządzeniach Samsunga, gdy aplikacja jest zatrzymywana lub wznawiana zbyt szybko (Iaca26).

Wersja 1.3.0-alpha03

25 stycznia 2023 r.

androidx.camera:camera-*:1.3.0-alpha03 został zwolniony. Wersja 1.3.0-alpha03 zawiera te commity.

Zmiany w interfejsie API

• Dodano CameraInfo.getIntrinsicZoomRatio, aby podać informacje o kącie widzenia w stosunku do kamery domyślnej. (Ib300c)
• Dodano CameraInfo.getLensFacing, aby podać informacje o kierunku soczewki. Dodano CameraSelector#LENS_FACING_EXTERNAL jako funkcję eksperymentalną do wybierania zewnętrznych kamer. (Icaf3e)
• Dodaj #setEffect() do CameraController, aby umożliwić dodawanie efektów do wyjścia z aparatu. (I1d21f)
• Dodaj metodę invalidate() do SurfaceRequest. Dostawca powierzchni może powiadomić, że wcześniej podana powierzchnia nie jest już ważna. (Idc649).
• Dodaj interfejs ImageProcessor API. Ten interfejs służy do wstawiania efektów końcowych do ścieżki ImageCapture. (I575c6)
• Dodano interfejs API Recorder.Builder.setAspectRatio(), który można łączyć z interfejsem QualitySelector, aby obsługiwać więcej rozdzielczości filmów. (I8a082)
• Dodano Recorder.Builder#setTargetVideoEncodingBitRate, aby ustawić docelowy kodowanie wideo BitRate i Recorder#getTargetVideoEncodingBitRate, aby uzyskać docelową szybkość transmisji bitów kodowania wideo. (I5984d)

Poprawki błędów

• Naprawiono błąd ImageCapture, gdy brak lampy błyskowej i jest włączony tryb lampy błyskowej. (I9e8b4, b/263391112)
• Rozwiązaliśmy problem z uszkodzeniem obrazu JPEG podczas zapisywania danych lokalizacji Exif na niektórych urządzeniach Samsung z Androidem 12. (Ib7086, b/263747161, b/263289024)
• gdy ustawienie latarki/zoomu nastąpiło przed zakończeniem inicjalizacji kamery, np. wywołanie CameraController#enableTorch, oczekujące działanie jest przechowywane w pamięci podręcznej i przesyłane po zakończeniu inicjalizacji. (I11e92, b/264157663)

Wersja 1.3.0-alpha02

7 grudnia 2022 r.

androidx.camera:camera-*:1.3.0-alpha02 został zwolniony. Wersja 1.3.0-alpha02 zawiera te commity.

Zmiany w interfejsie API

• dodać nowy interfejs API do stosowania efektu końcowego do danych wyjściowych podglądu. (Ic17d5).
• Zmieniono nazwę OutputOptions.getDurationLimit na OutputOptions.getDurationLimitMillis, a OutputOptions.setDurationLimit na OutputOptions.setDurationLimitMillis. (I91f0c)
• Dodaj klasę AudioConfig, aby obsługiwać ustawienia związane z dźwiękiem podczas nagrywania filmu. Adnotacja @RequiresPermission została przeniesiona z funkcji startRecording do AudioConfig, aby uniknąć niepotrzebnych próśb o uprawnienia w przypadkach, gdy dźwięk nie jest potrzebny. (I28755)
• Usuń klasy Metadata, OnVideoSavedCallback, OutputFileOptions i OutputFileResults, które nie są już używane po zastosowaniu nowego interfejsu API do przechwytywania wideo. (I38cd8).
• zastosuj nowy interfejs API do przechwytywania filmów; Metody getVideoCaptureTargetSize i setVideoCaptureTargetSize są odpowiednio zastępowane metodami getVideoCaptureTargetQuality i setVideoCaptureTargetQuality, ponieważ metoda setTargetResolution nie jest już obsługiwana. (I2a1d5).

Poprawki błędów

• Usuń wycofany interfejs API core.VideoCapture. (I531e0)
• Rozwiązaliśmy problem polegający na tym, że funkcja wywołania zwrotnego onError nie jest wywoływana podczas robienia zdjęć bez uprawnień do przechowywania (I936db, b/244807669).
• Ulepszona jakość i niezawodność rozszerzeń aparatu. Rozszerzenia aparatu są wyłączone na urządzeniach Motorola z wersją 1.1.0 lub starszą z powodu problemów z obsługą efektu bokeh, robieniem zdjęć i wznawianiem podglądu. (Id3ce3)
• Naprawiono błąd powodujący awarię aplikacji natywnej, gdy na starszych urządzeniach jest włączone przycinanie filmów za pomocą ViewPort. (I16b8a, b/251357665)

Wersja 1.3.0-alpha01

9 listopada 2022 r.

Usługa androidx.camera:camera-*:1.3.0-alpha01 została zwolniona. Wersja 1.3.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

• Kontener Camera-viewfinder został oficjalnie opublikowany. Camera-viewfinder udostępnia widżet podstawowego wizjera, który może wyświetlać obraz z kamery w przypadku Aparatu2. Przykład znajdziesz w przykładowym kodzie.

Zmiany w interfejsie API

• Dodano OutputOptions.setDurationLimit, aby umożliwić ustawienie limitu długości filmu. Nagranie zostanie automatycznie sfinalizowane po przekroczeniu określonego limitu czasu. (I902a0)
• Dodaj stan błędu dźwięku w nagrywaniu wideo AudioStats.AUDIO_STATE_SOURCE_ERROR. Wysyłane, gdy konfiguracja źródła dźwięku się nie powiedzie lub wystąpi jakiś błąd. (I37410)

Poprawki błędów

• Dodaj osobowość, aby umożliwić niektórym problematycznym urządzeniom ponowne przechwytywanie danych w przypadku niepowodzenia przechwytywania. (Id4795)
• Rozwiązanie problemu z czarnym ekranem w implementacji PreviewView SurfaceView w ViewPager2. W ramach poprawki PreviewView będzie ponownie używać SurfaceView, jeśli żądana rozdzielczość nie zostanie zmieniona. (Ib3f27)
• Obsługuj przycinanie filmów (funkcja WYSIWYG), gdy używany jest interfejs ViewPort lub CameraController API. (Ifbba8, b/201085351)
• Po naprawieniu filmu nagranego przednim aparatem nie można nagrać filmu Huawei P40 Lite. (I87c57, b/250807400)

Wersja 1.2

Wersja 1.2.3

24 maja 2023 r.

androidx.camera:camera-*:1.2.3 został zwolniony. Wersja 1.2.3 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że aplikacja VideoCapture nie działała z przednią kamerą na niektórych urządzeniach. Na przykład na telefonie Samsung Galaxy S23 i Xiaomi 2107113SG. (Ibec7e, b/270656244)

Wersja 1.2.2

22 marca 2023 r.

androidx.camera:camera-*:1.2.2 został zwolniony. Wersja 1.2.2 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązano problem polegający na tym, że rozszerzenia CameraX nie działają prawidłowo, gdy funkcja Proguard jest włączona na niektórych urządzeniach, takich jak Pixel (I90aa2).

Wersja 1.2.1

25 stycznia 2023 r.

androidx.camera:camera-*:1.2.1 został zwolniony. Wersja 1.2.1 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązanie problemu z uszkodzonymi obrazami JPEG podczas zapisywania danych o lokalizacji Exif na niektórych urządzeniach Samsung z Androidem 12. (b/263289024)

Wersja 1.2.0

7 grudnia 2022 r.

Usługa androidx.camera:camera-*:1.2.0 została zwolniona. Wersja 1.2.0 zawiera te zatwierdzenia.

Ważne zmiany od wersji 1.1.0

• nowa biblioteka camera-mlkit-vision. Z łatwością zintegruj aplikację CameraX z wieloma funkcjami MLKit, takimi jak skanowanie kodów kreskowych, wykrywanie twarzy czy tekst. Dodano MLKitAnalyzer jako nowe interfejsy API.
• Nowy eksperymentalny interfejs API typu Zero-Lag API. Optymalizuje przetwarzanie, aby zmniejszyć opóźnienie przy zachowaniu dobrej jakości obrazu. Gdy tryb rejestrowania jest ustawiony na CAPTURE_MODE_ZERO_SHUTTER_LAG, opóźnienie między naciśnięciem przycisku migawki a zrobieniem zdjęcia powinno być zminimalizowane w porównaniu z innymi trybami rejestrowania. Na urządzeniach, które nie obsługują ZERO_SHUTTER_LAG, zostanie użyty tryb CAPTURE_MODE_MINIMIZE_LATENCY.
• Wycofaj android.camera.core.VideoCapture.
• Dodano interfejs setStreamUseCase() jako publiczny interfejs API Camera2Interop.
• Dodano wymagania dotyczące poziomu interfejsu API dla setOutputImageRotationEnabled.
• Nazwa ImageAnalysis.Analyzer#getTargetResolutionOverride() została zmieniona na ImageAnalysis.Analyzer#getDefaultTargetResolution().
• Dodano interfejs API do ustawiania metadanych lokalizacji w zapisanym filmie.
• Rozwiązaliśmy problem z niską liczbą klatek na sekundę podczas korzystania z VideoCapture i w przypadku użycia formatu 16:9 w podglądzie.
• Rozwiązaliśmy problem z czarnym podglądem, który występuje, gdy na niektórych urządzeniach Samsunga włączone jest rozszerzenie BOKEH, a użytkownik przełącza kamery.
• Rozwiązano problem z wydłużeniem na urządzeniach Samsung J7 Prime (SM-G610M) i J7 (SM-J710MN) na poziomie interfejsu API 27.Preview/VideoCapture
• Wyłączono obejście problemu polegające na przechyleniu obszaru AF w poziomie w przypadku przednich aparatów na urządzeniach Samsung z Androidem T, ponieważ problem został rozwiązany

Wersja 1.2.0-rc01

24 października 2022 r.

androidx.camera:camera-*:1.2.0-rc01 został zwolniony. Wersja 1.2.0-rc01 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaj interfejs API setStreamUseCase dla OutputConfiguration. Użytkownik może określić zastosowanie strumienia na potrzeby sesji strumienia, zastępując wewnętrzną logikę CameraX, aby wybrać zastosowanie strumienia w celu optymalizacji zgodnie z potrzebami. (IB1A95).

Poprawki błędów

• Rozwiązano problem z wydłużeniem na urządzeniach Samsung J7 Prime (SM-G610M) i J7 (SM-J710MN) na poziomie interfejsu API 27.Preview/VideoCapture Rozdzielczość 1920 x 1080 powoduje rozciągnięcie obrazu Preview/VideoCapture. Dodano obejście problemu polegające na niewybieraniu rozdzielczości 1920 x 1080 w przypadku podglądu lub VideoCapture, aby uniknąć rozciągania obrazu. (I0e04e)
• Usunięto problem niskiej liczby klatek na sekundę podczas korzystania z funkcji VideoCapture i podglądu w formatach 16:9 na niektórych urządzeniach Huawei. (If8c88, b/223643510)
• Rozwiązaliśmy problem z otwarciem kamery, który powodował, że SurfaceProvider w podglądzie nie był ustawiony. W ramach poprawki podgląd bez ustawionego elementu SurfaceProvider nie będzie teraz konfigurowany w sesji nagrywania aparatem. (I99681)

Wersja 1.2.0-beta02

21 września 2022 r.

androidx.camera:camera-*:1.2.0-beta02 został zwolniony. Wersja 1.2.0-beta02 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaj wymagany poziom interfejsu API dla setOutputImageRotationEnabled (I26e3e, b/240993561)

Poprawki błędów

• Wyłączyliśmy obejście polegające na odwróceniu obszaru AF w poziomie w przypadku przednich aparatów na telefonie Samsung z Androidem T, ponieważ problem został rozwiązany. (I05f69)
• Rozwiązaliśmy problem z czarnym podglądem, który występuje, gdy na niektórych urządzeniach Samsunga włączone jest rozszerzenie BOKEH, a użytkownik przełącza kamery. (If6168)

Wersja 1.2.0-beta01

24 sierpnia 2022 r.

androidx.camera:camera-*:1.2.0-beta01 został zwolniony. Wersja 1.2.0-beta01 zawiera te zatwierdzenia.

Nowe funkcje

• Nowa biblioteka camera-mlkit-vision. Łatwo integruj CameraX z wieloma funkcjami MLKit, takimi jak skanowanie kodów kreskowych, wykrywanie twarzy, wykrywanie tekstu itp. Przykładowy kod znajdziesz tutaj.
• Nowy eksperymentalny interfejs API Zero-Shutter Lag API. Optymalizuje proces przechwytywania, aby uzyskać mniejsze opóźnienie przy zachowaniu dobrej jakości obrazu. Gdy tryb rejestrowania jest ustawiony na CAPTURE_MODE_ZERO_SHUTTER_LAG, opóźnienie między naciśnięciem przycisku migawki a zrobieniem zdjęcia powinno być zminimalizowane w porównaniu z innymi trybami rejestrowania. Na urządzeniach, które nie obsługują ZERO_SHUTTER_LAG, zostanie użyty tryb CAPTURE_MODE_MINIMIZE_LATENCY.
• ImageAnalysis.Analyzer i MLKitAnalyzer są teraz oficjalnymi interfejsami API.
• Interfejs API do ustawiania metadanych lokalizacji w zapisanym filmie.
• Zmień nazwę ImageAnalysis.Analyzer#getTargetResolutionOverride() na ImageAnalysis.Analyzer#getDefaultTargetResolution().

Poprawki błędów

• Rozwiązano problem z przechwytywaniem obrazu w przypadku modelu Alps k61v1_basic_ref. Zdjęte zdjęcia JPEG z HAL mają nieprawidłowe metadane EXIF. Metadane Exif nie zawierają tagu 0xffd9 ani 0xffda, aby ExifInterface poprawnie przeanalizował atrybuty. Aby obejść ten problem, rób zdjęcia w formacie YUV, a potem skompresuj je do formatu JPEG. (I45abb)

Wersja 1.2.0-alfa04

27 lipca 2022 roku

androidx.camera:camera-*:1.2.0-alpha04 został zwolniony. Wersja 1.2.0-alpha04 zawiera te commity.

Zmiany w interfejsie API

• Zmień nazwę ImageAnalysis.Analyzer#getTargetResolutionOverride() na ImageAnalysis.Analyzer#getDefaultTargetResolution(). Zmieniono też zachowanie, tak aby wartość zwracana przez tę metodę mogła być zastąpiona wartością z ImageAnalysis#setTargetResolution(). (If1d36)
• Interfejs API umożliwiający ustawienie metadanych lokalizacji w zapisanym filmie. Obiekt android.location.Location można skonfigurować za pomocą nowego interfejsu API androidx.camera.video.OutputOptions.Builder.setLocation(Location). (I313a0, b/204197544)

Poprawki błędów

• Rozwiązanie problemu z robieniem zdjęć z podglądem odłączania (Ie70b6, b/235119898)
• Rozwiązano problem z zawieszaniem się aplikacji Recorder podczas próby nagrywania, gdy źródło dźwięku jest niedostępne. (I9f652)

Wersja 1.2.0-alpha03

29 czerwca 2022 r.

androidx.camera:camera-*:1.2.0-alpha03 został zwolniony. Wersja 1.2.0-alfa03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Usunięto eksperymentalną adnotację dla ImageAnalysis.Analyzer i MLKitAnalyzer. (I0ff22)

Poprawki błędów

• Dodano domyślny czas oczekiwania automatycznego ostrości wynoszący 5000 ms. Powoduje on dodanie wartości isFocusSuccessful fałsz, jeśli zdarzenie FocusMeteringAction nie jest anulowane, a część AF nie jest zbieżna w czasie trwania. (Ibc2e3)
• Rozwiązanie problemu z robieniem zdjęć z podglądem odłączania (I1d3a2, b/235119898)
• Włączono zaawansowane rozszerzenie i zaktualizowano wersję interfejsu obsługi rozszerzeń CameraX do 1.2 (I92256).

Wersja 1.2.0-alpha02

1 czerwca 2022 r.

androidx.camera:camera-*:1.2.0-alpha02 został zwolniony. Wersja 1.2.0-alpha02 zawiera te commity.

Nowe funkcje

• Udostępnij interfejs CameraX Zero-Shutter Lag API jako eksperymentalny.

Zmiany w interfejsie API

• Dodaj nowy tryb przechwytywania CAPTURE_MODE_ZERO_SHUTTER_LAG w ImageCapture i dodaj isZslSupported w CameraInfo, aby zapytać o możliwości urządzenia. CAPTURE_MODE_ZERO_SHUTTER_LAG ma zapewnić minimalne opóźnienie w przypadku natychmiastowego przechwytywania. Jest ona realizowana na podstawie pierścieniowego bufora, który przechowuje tymczasowe wyniki przechwytywania w pamięci podręcznej na potrzeby późniejszego ponownego przetwarzania, gdy użytkownik naciska przyciski do robienia zdjęć. Jeśli {@link VideoCapture} jest powiązany lub tryb lampy błyskowej nie jest WYŁĄCZONY albo rozszerzenie OEM jest WŁĄCZONE, ten tryb zostanie wyłączony automatycznie. (I9ae74).
• Dodaj metodę ImageAnalysis.getBackgroundExecutor() (Icc945)

Poprawki błędów

• Naprawiono błąd ImageCapture – metoda takePicture wyłącza latarkę na zgłoszonych urządzeniach. (Ib5eb5, b/228272227)
• Naprawiono błąd, przez który obiekt AssertionError nie był obsługiwany podczas pobierania cechy CONTROL_ZOOM_RATIO_RANGE.(/Ia248a, b/231701345)

Wersja 1.2.0-alpha01

18 maja 2022 r.

androidx.camera:camera-*:1.2.0-alpha01 został zwolniony. Wersja 1.2.0-alpha01 zawiera te commity.

Nowe funkcje

• Nowa biblioteka camera-mlkit-vision jest dostępna

Poprawki błędów

• Naprawiono błąd, który powodował, że QualitySelector nie nagrywało filmów w jakości UHD, gdy włączona była strategia zastępcza. Problem występuje, gdy VideoCapture jest powiązany z ImageCapture i podglądem na urządzeniu z kamerą o pełnym lub wyższym poziomie sprzętu. Strategia zastępcza QualitySelector powoduje, że VideoCapture nieprawidłowo uzyskuje rozdzielczość FHD. Rozdzielczość UHD jest rzeczywiście obsługiwana w tym połączeniu przypadku użycia i należy ją zastosować. (I0e788, b/230651237)
• Naprawiono NullPointerException (ImageCapture.takePicture()). (I92366, b/230454568, b/229766155)
• Poprawka zachowania asynchronicznego wstrzymywania androidx.camera.video.Recorder (Ia8ce8)

Camera-Camera2, Camera-Core, Camera-Lifecycle i Camera-Video w wersji 1.1.0

Wersja 1.1.0

29 czerwca 2022 r.

androidx.camera:camera-*:1.1.0 został zwolniony. Wersja 1.1.0 zawiera te zatwierdzenia.

Ważne zmiany wprowadzone od wersji 1.0.0

• biblioteki Landed View, Extension i Video Capture w pierwszej wersji RC. Od wersji 1.1.0-beta01 wszystkie biblioteki CameraX będą miały ten sam numer wersji. Ułatwi to programistom śledzenie wersji i zmniejszy złożoność dużych matryc zgodności wersji.
• Wprowadziliśmy nowe publiczne interfejsy API i funkcje, w tym:
• Dodaj oficjalną bibliotekę filmów z kamery, aby umożliwić nagrywanie filmów.
• Możliwość konwersji YUV na RGB i rotacji (ImageAnalysis.Builder.setOutputImageRotationEnabled i setOutputImageFormat)
• Obsługa trybu wielookiennego przez umożliwienie aplikacjom CameraX wznowienia korzystania z aparatu, gdy zostanie on przerwany przez inną aplikację i ponowne skupienie na nim.
• Po rozwiązaniu problemów z podglądem aparat CameraX działa dobrze na urządzeniach składanych.
• Dodano interfejs API CameraState, który będzie dostępny za pomocą interfejsu CameraInfo.
• Dodano interfejs API ProcessCameraProvider.getAvailableCameraInfos() do bezpośredniego pobierania informacji o dostępnych kamerach
• Format wyjściowy JPEG dla ImageCapture#OnImageCapturedCallback, gdy włączone są rozszerzenia.
• Dodano interfejs API isFocusMeteringSupported w CameraInfo, który umożliwia aplikacjom sprawdzenie, czy dany FocusMeteringAction jest obsługiwany przez bieżącą kamerę.
• Wyświetlany interfejs API getResolutionInfo, który udostępnia informacje o rozdzielczości w przypadku podglądu, ImageCapture i ImageAnalysis.
• Dodano nowy interfejs API ImageCapture.Builder#setJpegQuality, który umożliwia zmianę jakości kompresji wyjściowego obrazu JPEG podczas robienia zdjęć.
• Dodano do publicznego interfejsu API funkcję CameraSelector#filter, która umożliwia filtrowanie listy CameraInfos na podstawie CameraSelector.
• Dodano Camera2CameraControl.clearCaptureRequestOptions do wyczyszczania istniejących opcji żądania przechwytywania.
• Dodano eksperymentalny interfejs API do korzystania z CameraController z zewnętrzymi bibliotekami do przetwarzania obrazu, np. MLKit.
• Dodano eksperymentalny interfejs API CameraInfo#getCameraSelector(), który zwraca CameraSelector unikalny dla danego aparatu.
• kilka eksperymentalnych interfejsów API zostało awansowanych do formalnych publicznych interfejsów API;
• W przypadku interfejsów API w wersji eksperymentalnej zastąpiono adnotację @Experimental adnotacją @RequiresOptIn. Do wywoływania eksperymentalnych interfejsów API użyj adnotacji androidx.annotation.OptIn zamiast wycofanej adnotacji androidx.annotation.experimental.UseExperimental.
• Zaktualizowaliśmy te eksperymentalne interfejsy API do wersji oficjalnych: CameraXConfig.Builder#setAvailableCamerasLimiter(), CameraXConfig.Builder#setMinimumLoggingLevel(), CameraXconfig.Builder#setSchedulerHandler(), CameraXConfig#getAvailableCamerasLimiter(), CameraXConfig#getMinimumLoggingLevel(), CameraXConfig#getCameraExecutor(), CameraXConfig#getSchedulerHandler(),
• @ExperimentalCameraFilter Interfejsy API
• eksperymentalne interfejsy API do kompensacji ekspozycji.
• Promowanie eksperymentalnego interfejsu API UseCaseGroup dla modułu camera-core, modułu camera-lifecycle i modułu camera-video. Dodano ViewPort#getLayoutDirection, ViewPort.Builder#setLayoutDirection i ViewPort.Builder#setScaleType do dostosowywania widocznego obszaru.
• ExperimentalUseCaseGroupLifecycle awansował do rangi oficjalnych publicznych interfejsów API.
• Zmiany w istniejących interfejsach API
• Renamed MediaStoreOutputOptions.getCollection, by MediaStoreOutputOptions.getCollectionUri.
• Funkcja ActiveRecording została zmieniona na „Nagrywanie”, aby zmniejszyć szczegółowość.
• Zmieniliśmy interfejs API dla twórców QualitySelector na interfejs API oparty na listach.

Poprawki błędów

• Rozwiązaliśmy problem z YuvToJpegProcessor EOFException, gdy włączony jest tryb rozszerzenia i ustawiono tryb ImageCapture#CAPTURE_MODE_MAX_QUALITY.
• Konfiguracja kodeka nie powiodła się z powodu zamykania nagrywania wideo
• Poprawiono współczynnik proporcji rozciągniętego podglądu/filmu podczas nagrywania w jakości FHD
• Rozwiązaliśmy problem z brakiem synchronizacji dźwięku i obrazu po wstrzymaniu i wznowieniu odtwarzania na niektórych urządzeniach.
• Rozwiązaliśmy problem, który powodował, że lampa błyskowa była aktywowana podczas dotknięcia ostrości (startFocusAndMetering), gdy lampa błyskowa jest w trybie automatycznym lub zawsze włączona w słabym oświetleniu.

Wersja 1.1.0-rc02

1 czerwca 2022 r.

Usługa androidx.camera:camera-*:1.1.0-rc02 została zwolniona. Wersja 1.1.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiono błąd NullPointerException w wersji ImageCapture.takePicture(). (I92366, b/230454568, b/229766155)
• Usunęliśmy błąd polegający na tym, że podczas pobierania właściwości CONTROL_ZOOM_RATIO_RANGE nie był obsługiwany parametr CONTROL_ZOOM_RATIO_RANGE.AssertionError (Ia248a, b/231701345)

Wersja 1.1.0-rc01

11 maja 2022 roku

androidx.camera:camera-*:1.1.0-rc01 został zwolniony. Wersja 1.1.0-rc01 zawiera te zatwierdzenia.

Nowe funkcje

• Opublikuj pierwszą wersję RC dla obrazu z kamery, widoku z kamery i rozszerzenia kamery

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że kodek wideo nie był uwalniany, gdy VideoCapture<Recorder> był odłączony, co powodowało, że kolejne użycia VideoCapture<Recorder> kończyły się niepowodzeniem podczas nagrywania za pomocą MediaCodec.CodecException, zwłaszcza na urządzeniach z poziomem interfejsu API 21–22. (Ie7f68)
• Poprawka zdjęć, które przedstawiają CameraExtensionsActivity, nie będą usuwane w aplikacji ImageCaptureTest

Wersja 1.1.0-beta03

6 kwietnia 2022 roku

androidx.camera:camera-*:1.1.0-beta03 został zwolniony. Wersja 1.1.0-beta03 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Zmiana konstruktora CaptureRequestOptions w taki sposób, aby był on ograniczony. (I261b6)
• Dodano eksperymentalne API do korzystania z CameraController z zewnętrzymi bibliotekami do przetwarzania obrazów, np. MLKit (I4ea71).

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że podgląd w trybie PreviewView był wyświetlany w poziomie, gdy nie udawało się ponownie uruchomić aktywności po obróceniu urządzenia w trybie wielookiennym. (I1ea36, b/223488673)
• Rozwiąż problem z trybem wielu okien, który po zmianie ostrości z powrotem na aplikację nie powoduje wznowienia aparatu, gdy (1) inna aplikacja o wysokim priorytecie otwiera inny aparat (2) urządzenie to Samsung z Androidem 12. (I7e9f2)
• obejście problemu w przypadku urządzeń, które ulegają awarii podczas sprawdzania dostępności lampy błyskowej; Na tych urządzeniach nie będzie dostępnego trybu latarki. (If26a3, b/216667482)
• Rozwiązanie problemu AbstractMethodError, który występował, gdy aplikacje korzystają z rozszerzeń i włączają ProGuard. (I7cbaf, b/222726805)
• Wymuszaj wyłączenie trybu rozszerzenia bokeh na urządzeniu Motorola Razr 5G, co spowoduje problem z czarnym ekranem podglądu. (I35d49)
• Naprawiono problem z brakiem synchronizacji dźwięku i obrazu po wstrzymaniu i wznowieniu odtwarzania na niektórych urządzeniach Samsunga z wersją API 29 lub starszą. (I64622, b/202798609, b/202798572)
• Rozwiązano problem z brakiem synchronizacji dźwięku i obrazu po wstrzymaniu i wznowieniu odtwarzania na urządzeniu Sony G3125. (I2a1a5, b/202799148)
• Naprawiono błąd powodujący awarię, gdy nagrywarka napotkała błąd InvalidConfigException. Ta poprawka zapobiega tylko awariom aplikacji, ale nie rozwiązuje przyczyny InvalidConfigException. Jeśli nadal nie będzie można skonfigurować urządzenia Recorder, po rozpoczęciu nagrywania aplikacje otrzymają wywołanie zwrotne o błędzie. (I89c29, b/213617227)

Darowizna zewnętrzna

• zaktualizowano :compose:ui:ui-test api (updateApi) ze względu na migrację test-coroutines-lib (I3366d)

Wersja 1.1.0-beta02

23 lutego 2022 r.

androidx.camera:camera-*:1.1.0-beta02 został zwolniony. Wersja 1.1.0-beta02 zawiera te commity.

Zmiany w interfejsie API

• Dodano możliwość określenia identyfikatora fizycznej kamery za pomocą Camera2Interop. (I5aed8)

Poprawki błędów

• Rozwiązanie problemu z rozciągniętym podglądem na Oppo Find N (I7d004)
• Naprawiono zniekształcony podgląd w Galaxy J7 Prime. (I4c500)
• Użyj zgodnego bitrate’u, aby znaleźć koder wideo. (D969052)

Wersja 1.1.0-beta01

26 stycznia 2022 r.

androidx.camera:camera-*:1.1.0-beta01 został zwolniony. Wersja 1.1.0-beta01 zawiera te commity.

Nowe funkcje

• Od wersji 1.1.0-beta01 wszystkie biblioteki CameraX będą miały ten sam numer wersji. Ułatwi to programistom śledzenie wersji i zmniejszy złożoność dużej macierzy zgodności wersji.

Zmiany interfejsu API

• Dodano Camera2CameraControl.clearCaptureRequestOptions do wyczyszczania dotychczasowych opcji żądania przechwytywania. (Ifa07d)

Poprawki błędów

• Naprawiono błąd, który powodował awarię podczas nagrywania filmów na niektórych urządzeniach z Androidem w wersji O(interfejs API 26). (I88fdf, b/212328261)
• Rozwiązaliśmy problem z nieprawidłowym obszarem AF podczas używania cameraControl#startFocusAndMetering() na przednim aparacie urządzeń Samsung (Ifbf59, b/210548792)
• Użyj latarki jako lampy błyskowej na Pixelu 3a lub Pixelu 3a XL, aby zwiększyć szybkość i jakość zdjęć w ciemnych warunkach (Ib12b6, b/211474332)
• Umożliwia aplikacjom wznowienie korzystania z kamery, gdy zostanie ono przerwane przez inną aplikację o wyższym priorytecie w trybie wielookiennym i ponowne skupienie się na aplikacji. Pamiętaj, że ze względu na problemy z ramką może wystąpić opóźnienie(od 1 do 10 sekund lub dłużej) między zmianą ostrości a otwarciem aparatu. (I4D092)

Wersja 1.1.0-alpha12

15 grudnia 2021 roku

androidx.camera:camera-*:1.1.0-alpha12 został zwolniony. Wersja 1.1.0-alpha12 zawiera te commity.

Zmiany w interfejsie API

• Z klas/interfejsów wewnętrznych usunięto niepotrzebne adnotacje @RequiresApi(21). (I8e286, b/204917951)
• Stałe jakości i stałe strategii kreacji zastępczej QualitySelector zostały zmienione, by były reprezentowane przez obiekty klas. Na przykład pole QualitySelector.QUALITY_HD zostało zmienione na Quality.HD, a pole QualitySelector.FALLBACK_STRATEGY_LOWER zostaje zmienione na instancję zwracaną przez FallbackStrategy.lowerQualityOrHigherThan(Quality). Interfejs API używany do tworzenia QualitySelector został zmieniony na interfejs API oparty na listach. Nowy interfejs API QualitySelector.fromOrderedList(List<Quality>) będzie się odnosić do kolejności listy jakości danych wejściowych zamiast do kolejności utworzonej przez QualitySelector.Procedure. QualitySelector.Procedure zajęcia zostało usunięte. (I43343)
• Detektor zdarzeń PendingRecording.withEventListener() został usunięty, a detektor zdarzenia musi teraz być przekazywany do PendingRecording.start(). To wymaganie dotyczące detektora zdarzeń ma zachęcać do obsługi błędów asynchronicznych zgłaszanych w zdarzeniu VideoRecordEvent.Finalize. (I1e71d)
• Aby zmniejszyć ilość informacji, nazwa ActiveRecording została zmieniona na Recording. (I77CEb)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że zdjęcia robione w trybie FLASH_AUTO były niedoświetlone w ciemnych warunkach na Pixelu 3a i Pixelu 3a XL (I13f19, b/205373142)
• Zawsze używaj najnowszego rozmiaru wyświetlania do określenia podglądu Resolution. (I4a694)
• Odfiltrowano kamery, które nie mają REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE. Kamery z REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE mają minimalny zestaw funkcji, który jest obsługiwany przez każde urządzenie z kamerą. Aparat bez funkcji REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE może być kamerą obsługującą specjalne funkcje, ale nie obsługuje standardowych kolorów. CameraX nie obsługuje przypadków użycia Preview, ImageCapture, ImageAnalysis ani VideoCapture w przypadku tych kamer. Dlatego te kamery powinny być odfiltrowywane, aby zapobiec nieprawidłowemu użyciu. (Ib8cda)
• Funkcja CameraSelector#filter nie zwraca już błędu IllegalArgumentException, gdy zbiór wyników jest pusty. (I27804)
• Do wybierania ustawień kodera na podstawie profili określonych przez producenta używane są teraz bardziej inteligentne heurystyki. (Iaeef0)
• Po rozpoczęciu nagrywania filmów w jakości UHD na Pixelu 1 podgląd będzie zawierał przeplatane kolorowe linie. (I833c6, b/205340278)

Wersja 1.1.0-alpha11

17 listopada 2021 r.

androidx.camera:camera-*:1.1.0-alpha11 został zwolniony. Wersja 1.1.0-alpha11 zawiera te commity.

Zmiany w interfejsie API

• Dodano do publicznego interfejsu API metodę CameraSelector#filter, która umożliwia filtrowanie listy obiektów CameraInfo na podstawie obiektu CameraSelector. (I105d0)

• Dodaj interfejs API setOutputImageRotationEnabled do konfiguracji ImageAnalysis. Użytkownik może włączyć obrót dla bufora obrazu YUV/RGB. Stopień obrotu to obrót względny obliczany na podstawie obrotu czujnika i obrotu docelowego, aby obraz był widoczny na pierwszym planie.

• Dodano interfejs API setOutputImageRotationEnabled dla konfiguracji ImageAnalysis. Użytkownik może włączyć obrót dla bufora obrazu YUV/RGB. Stopień obrotu to obrót względny obliczony na podstawie obrotu czujnika i docelowego obrotu, aby obraz był widoczny z przodu.

  Dodaj interfejs API getSensorToBufferTransformMatrix w ImageInfo. Zwrócona tablica to mapowanie współrzędnych czujnika na współrzędne bufora, czyli od wartości CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE do (0, 0, image.getWidth, image.getHeight). Tablicy można używać do mapowania współrzędnych z jednego {UseCase} na inne. Dotyczy to na przykład mapowania współrzędnych twarzy wykrytej za pomocą analizy ImageAnalysis na podgląd. (I9ff1e)

• Dodano nowe API ImageCapture.Builder#setJpegQuality, aby umożliwić zmianę jakości kompresji obrazu JPEG podczas robienia zdjęć. (I8dcf4)

• Nazwę MediaStoreOutputOptions.getCollection zmieniono na MediaStoreOutputOptions.getCollectionUri. (I16639)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że lampa błyskowa była uruchamiana podczas skupiania ostrości przez dotknięcie (startFocusAndMetering), gdy tryb lampy błyskowej był ustawiony na „auto” lub „zawsze_włączona” w środowisku o słabym oświetleniu. (Id4c11).
• Wyłączenie HDR+ na Pixelu 2 XL / Pixelu 3 XL w trybie MINIMIZE_LATENCY w celu zmniejszenia opóźnienia. (Ib6270, b/203505523)

Darowizna zewnętrzna

Wersja 1.1.0-alfa10

13 października 2021 r.

androidx.camera:camera-*:1.1.0-alpha10 został zwolniony. Wersja 1.1.0-alpha10 zawiera te commity.

Nowe funkcje

• Opublikowano androidx.camera:camera-video:1.1.0-alpha10 jako pierwszą wersję alfa dla usługi wideo. W późniejszych wersjach zostanie rozwiązanych kilka znanych problemów.

Zmiany w interfejsie API

• Dodano adnotację @RequiresApi(21) do wszystkich klas CameraX oraz usunięto minSdkVersion z pliku AndroidManifest.xml. Dzięki temu bibliotekę camera-core można łatwo zintegrować z aplikacjami, które mają wartość minSdkVersion mniejszą niż 21, ale warunkowo używają ścieżek kodu, które korzystają z interfejsu API 21 lub nowszego. W przypadku aplikacji z parametrem minSdkVersion 21 lub nowszym nie musisz nic robić. (Ie7f2e, b/200599470)

Poprawki błędów

• Wyjątek InitializationException powoduje, że aplikacja może prawidłowo obsłużyć błąd AssertionError występujący podczas tworzenia obiektu CameraCharacteristics. (Ibec79).

Wersja 1.1.0-alpha09

29 września 2021 r.

androidx.camera:camera-camera2:1.1.0-alpha09, androidx.camera:camera-core:1.1.0-alpha09 i androidx.camera:camera-lifecycle:1.1.0-alpha09 zostały udostępnione. Wersja 1.1.0-alpha09 zawiera te commity.

Zmiany interfejsu API

• Adnotacja ExperimentalUseCaseGroup została usunięta, ponieważ interfejsy API nie są już eksperymentalne. (I01ef5)

Poprawki błędów

• Rozwiązanie problemu polegającego na tym, że zdjęcia zrobione w trybie MAXIMIZE_QUALITY są rozmyte. (I173a9, b/193823892)
• Rozwiązano problem z Samsung Galaxy J5, w którym aparat zacinał się po zrobieniu zdjęć z włączoną lub automatyczną lampą błyskową w ciemnym otoczeniu (I3aab9).
• Gdy wymagane jest przycięcie w ImageCapture, skompresowanie wynikowego przyciętego obrazu z określonym poziomem jakości JPEG zgodnie z ustawionym trybem rejestracji. Jeśli tryb rejestrowania to CAPTURE_MODE_MINIMIZE_LATENCY, jakość kompresji JPEG będzie wynosić 95. Jeśli tryb rejestrowania to CAPTURE_MODE_MAXIMIZE_QUALITY, jakość kompresji JPEG będzie wynosić 100. (Ieb37c, b/142856426)

Wersja 1.1.0-alpha08

18 sierpnia 2021 r.

Funkcje androidx.camera:camera-camera2:1.1.0-alpha08, androidx.camera:camera-core:1.1.0-alpha08 i androidx.camera:camera-lifecycle:1.1.0-alpha08 są dostępne. Wersja 1.1.0-alpha08 zawiera te commity.

Nowe funkcje

• Dodano interfejs API setOutputImageFormat do konfiguracji analizy obrazu. Użytkownik może wybrać ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888 lub ImageAnalysis.OUTPUT_IMAGE_FORMAT_RGBA_8888. Domyślnie wybrana zostanie opcja ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888. (I7902D)

Zmiany interfejsu API

• Adnotacja ExperimentalUseCaseGroupLifecycle została usunięta, ponieważ interfejsy API nie są już eksperymentalne. (I17b85)

Poprawki błędów

• Rozwiązanie problemu polegający na tym, że ekran podglądu na telefonie Huawei P20 Lite jest zbyt jasny. Ten problem występuje tylko wtedy, gdy używane są określone specjalne rozdzielczości podglądu w połączeniu z dużym powiększeniem. (Idefce, b/192129158)
• Rozwiązaliśmy problem, który powodował, że lampka błyskowa nie działała na niektórych urządzeniach, gdy po ustawieniu lampy błyskowej na FLASH_MODE_ON wkrótce nastąpiło zrobienie zdjęcia. (Ieb49b)
• Rozwiązaliśmy problem polegający na tym, że podczas robienia zdjęć podgląd na jakiś czas się zatrzymuje, jeśli powiązane funkcje Przechwytywanie obrazu, Przechwytywanie obrazu i Podgląd są powiązane. (I56197, b/193864120)
• Umożliwia funkcji ImageAnalysis wybranie rozdzielczości większej niż 1080p. Urządzenie o poziomie co najmniej LIMITED może obsługiwać rozmiar RECORD dla ImageAnalysis, gdy jest ono powiązane z Preview i ImageCapture. Różnica polega na tym, że wybrana rozdzielczość przechwytywanego obrazu musi być ustawiona jako rozdzielczość w formacie RECORD. Aby wybrać rozdzielczość rozmiaru RECORD dla ImageAnalysis, należy ustawić docelową rozdzielczość rozmiaru RECORD zarówno w ImageCapture, jak i w ImageAnalysis. Oznacza to, że aplikacja wyraźnie rozumie kompromis i preferuje większą rozdzielczość dla ImageAnalysis niż dla ImageCapture. Definicje Rekordów i maksymalnych rozmiarów znajdziesz na stronie https://developer.android.com/reference/android/hardware/camera2/CameraDevice#regular-capture. Rozmiar RECORD odnosi się do maksymalnej obsługiwanej rozdzielczości nagrywania przez urządzenie z kamerą, zgodnie z ustawieniem CamcorderProfile. Rozmiar MAKSYMALNY odnosi się do maksymalnej rozdzielczości wyjściowej urządzenia do rejestrowania obrazu w danym formacie lub do wartości docelowej z metody StreamConfigurationMap.getOutputSizes(int). (I1ee97, b/192911449)
• Dodaj informacje Exif do zrobionego zdjęcia. (I01ff0, b/193342619)
• W ImageCapture zwraca identyfikator URI zapisanego obrazu, jeśli lokalizacja zapisu to Plik. (Ib5b49, b/149241379)
• Rozwiązaliśmy problem, który powodował, że zdjęcia z lampą błyskową były ciemne na wielu urządzeniach. (I4e510)

Wersja 1.1.0-alpha07

21 lipca 2021 r.

Funkcje androidx.camera:camera-camera2:1.1.0-alpha07, androidx.camera:camera-core:1.1.0-alpha07 i androidx.camera:camera-lifecycle:1.1.0-alpha07 są dostępne. Wersja 1.1.0-alpha07 zawiera te commity.

Poprawki błędów

• Usunęliśmy problem z telefonem Samsung Galaxy Note 5 polegający na zacinaniu się po zrobieniu zdjęć z włączoną i automatyczną lampą błyskową w ciemnym otoczeniu (If6871)
• Rozwiązaliśmy problem YuvToJpegProcessor EOFException, który występował, gdy włączony był tryb rozszerzenia i ustawiono tryb ImageCapture#CAPTURE_MODE_MAX_QUALITY. (I538bd, b/192017012)

Wersja 1.1.0-alpha06

30 czerwca 2021 r.

Funkcje androidx.camera:camera-camera2:1.1.0-alpha06, androidx.camera:camera-core:1.1.0-alpha06 i androidx.camera:camera-lifecycle:1.1.0-alpha06 są dostępne. Wersja 1.1.0-alpha06 zawiera te commity.

Zmiany w interfejsie API

• Promowanie eksperymentalnych interfejsów API do kompensacji ekspozycji w przypadku biblioteki camera-core (I08ee8)
• Dodano interfejs API isFocusMeteringSupported w informacjach o aparacie, który umożliwia aplikacjom sprawdzenie, czy podana akcja FocusMeteringAction jest obsługiwana przez bieżący aparat. (Ib45ae, b/188606490)
• Ujawniono interfejs API getResolutionInfo, aby udostępnić informacje o rozdzielczości na potrzeby funkcji Preview, ImageCapture i ImageAnalysis. (I2b613, b/188600718)
• Zmieniliśmy te eksperymentalne interfejsy API na oficjalne: CameraXConfig.Builder#setAvailableCamerasLimiter(), CameraXConfig.Builder#setMinimumLoggingLevel(), CameraXconfig.Builder#setSchedulerHandler(), CameraXConfig#getAvailableCamerasLimiter(), CameraXConfig#getMinimumLoggingLevel(), CameraXConfig#getCameraExecutor(), CameraXConfig#getSchedulerHandler(). (I2ade2)
• Udostępniono interfejs CameraProvider, aby umożliwić dostęp do zestawu kamer. (I1a7b1)
• Promowanie eksperymentalnego interfejsu UseCaseGroup API w przypadku interfejsów camera-core, camera-lifecycle i camera-video. Dodano parametry ViewPort#getLayoutDirection, ViewPort.Builder#setLayoutDirection i ViewPort.Builder#setScaleType do dostosowywania widoku. (I7cee8)

Wersja 1.1.0-alpha05

2 czerwca 2021 r.

Funkcje androidx.camera:camera-camera2:1.1.0-alpha05, androidx.camera:camera-core:1.1.0-alpha05 i androidx.camera:camera-lifecycle:1.1.0-alpha05 są dostępne. Wersja 1.1.0-alpha05 zawiera te commity.

Zmiany w interfejsie API

• Usunięto zajęcia Camera2CameraFilter. Sugerować wybór kamery za pomocą CameraFilter i pobieranie informacji z CameraCharacteristics lub innych informacji związanych z Camera2 za pomocą Camera2CameraInfo (w razie potrzeby). (Ib887c)
• ExperimentalCameraFilter Interfejsy API nie są już w fazie eksperymentalnej i stają się oficjalnymi interfejsami API. Można ich używać bez adnotacji OptIn. (I4bc94)
• Dodano interfejs API stanu aparatu, który jest dostępny za pomocą CameraInfo#getCameraState(). (Ia86b4)
• Dodano eksperymentalny interfejs API CameraInfo#getCameraSelector(), który zwraca obiekt CameraSelector, który jest unikalny dla danej kamery (I77f9f).

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że zwracany przez ListenableFuture obiekt setZoomRatio i setLinearZoom nie mógł zostać ukończony na niektórych urządzeniach z Androidem 11 (I716d7).
• przyspieszenie przełączania kamery i zmniejszenie częstotliwości występowania błędów w urządzeniu z kamerą (I34c99);
• Zmiana ExperimentalUseCaseGroupLifecycle na ExperimentalUseCaseGroup. (I3b2ef, b/159033688)

Wersja 1.1.0-alpha04

21 kwietnia 2021 r.

Funkcje androidx.camera:camera-camera2:1.1.0-alpha04, androidx.camera:camera-core:1.1.0-alpha04 i androidx.camera:camera-lifecycle:1.1.0-alpha04 są dostępne. Wersja 1.1.0-alpha04 zawiera te commity.

Poprawki błędów

• Naprawiono wyciek pamięci spowodowany przez dostęp do tej samej kolekcji przez wiele wątków jednocześnie. Wyciek pamięci może spowodować, że aktywność lub fragment zostaną zachowane przez instancję podglądu. (I7b4b8)
• W przypadku interfejsów API w wersji eksperymentalnej zastąpiono adnotację @Experimental adnotacją @RequiresOptIn. Do wywoływania eksperymentalnych interfejsów API używaj interfejsu androidx.annotation.OptIn zamiast wycofanego androidx.annotation.experimental.UseExperimental. (Iff226)
• Na telefonie Samsung Galaxy S7 poprawiono robienie wyblakłych obrazów z włączoną/automatyczną lampą błyskową. (I30001).
• Dodano interfejs CameraState API, który będzie dostępny za pośrednictwem interfejsu CameraInfo. (I75392)

Wersja 1.1.0-alpha03

24 marca 2021 r.

Funkcje androidx.camera:camera-camera2:1.1.0-alpha03, androidx.camera:camera-core:1.1.0-alpha03 i androidx.camera:camera-lifecycle:1.1.0-alpha03 są dostępne. Wersja 1.1.0-alpha03 zawiera te commity.

Poprawki błędów

• Format wyjściowy JPEG dla ImageCapture#OnImageCapturedCallback, gdy włączone są tryby rozszerzeń. (I0d7b1)
• Poprawiono błąd inicjalizacji na urządzeniach UMIDIGI BISON (I57d9e, b/180818665).
• Rozwiązano problem z rozciągniętym podglądem Samsunga A3 w PreviewView. (Iacb30, b/180121821)

Wersja 1.1.0-alpha02

24 lutego 2021 r.

androidx.camera:camera-camera2:1.1.0-alpha02, androidx.camera:camera-core:1.1.0-alpha02 i androidx.camera:camera-lifecycle:1.1.0-alpha02 zostały udostępnione. Wersja 1.1.0-alpha02 zawiera te commity.

Zmiany interfejsu API

• Dodano interfejs API ProcessCameraProvider.getAvailableCameraInfos(), aby bezpośrednio pobierać informacje o dostępnych aparatach, czyli wszystkich aparatach urządzenia lub tych wybranych przez zasadę CameraSelector podaną w zasadzie CameraXConfig.Builder.setAvailableCamerasLimiter(CameraSelector). (Ieac08)

Poprawki błędów

• CameraX próbuje teraz wymusić otwarcie aparatu przy pierwszym użyciu. Może to spowodować, że CameraX przechwyci aparat od innych klientów, jeśli ma wyższy priorytet. (IAb069, b/175820568)
• Usunięto błąd testu Robolectric, który występował, gdy w CameraXConfig użyto funkcji setAvailableCamerasLimiter. (Ice307)
• Ta zmiana przechwytuje wyjątek, gdy kolejka obrazów jest maksymalnie wykorzystana w ImageAnalysis. Zamiast awarii może się zdarzyć, że inne przypadki użycia będą działać wolno lub będą zamarzać, np. zamarzanie podglądu. (Ic12da, b/175851631)
• Naprawiono ExtensionsErrorListener, aby zgłaszać błędy, gdy tylko podgląd lub ImageCapture są powiązane. (I5ae39)
• Usunięto regres wydajności ImageCapture przez usunięcie weryfikacji zapisanej lokalizacji obrazu przed zrobieniem zdjęcia. Jeśli miejsce docelowe zapisu jest nieprawidłowe, odpowiedź o błędzie pojawi się później, ponieważ po zrobieniu zdjęcia zostanie podjęta próba zapisania zdjęcia. (I1fd4e, b/177061560)
• Rozwiązano problem regresji wydajności ImageCapture w przypadku typu „Plik” w opcjach wyjściowych OutputFileOptions. (I5164a, b/177061560)
• Zaktualizowaliśmy dokumentację, aby nie zalecać używania właściwości ProcessCameraProvider.configureInstance(...) z kodu biblioteki. (Ib8a9f)

Wersja 1.1.0-alpha01

27 stycznia 2021 r.

androidx.camera:camera-camera2:1.1.0-alpha01, androidx.camera:camera-core:1.1.0-alpha01 i androidx.camera:camera-lifecycle:1.1.0-alpha01 zostały udostępnione. Wersja 1.1.0-alpha01 zawiera te commity.

Poprawki błędów

• obejście problemu polegające na tym, że sporadycznie uszkodzone dane obrazu w pliku JPEG na tylnym aparacie SM-G930T (I52001, b/159831206)
• Rozwiązaliśmy problem IllegalArgumentException, który występował, gdy wszystkie obsługiwane rozmiary podglądu były mniejsze niż 640 x 480, a rozmiar wyświetlania był większy niż 640 x 480. (I2a63c, b/150506192)
• Zasoby w bibliotekach bez wyraźnie zadeklarowanych zasobów publicznych (np. za pomocą pliku public.xml) są teraz domyślnie prywatne. (Ia1dcc, b/170882230)

Camera-Camera2, Camera-Core i Camera-Lifecycle w wersji 1.0.2

Wersja 1.0.2

29 września 2021 r.

androidx.camera:camera-camera2:1.0.2, androidx.camera:camera-core:1.0.2 i androidx.camera:camera-lifecycle:1.0.2 zostały udostępnione. Wersja 1.0.2 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiąż problem z rozmyciem zrobionych zdjęć w trybie MAXIMIZE_QUALITY. (I173a9, b/193823892)
• Rozwiązaliśmy problem, który powodował, że zdjęcie z lampą błyskową było ciemne na wielu urządzeniach. (I4e510)

Camera-Camera2, Camera-Core i Camera-Lifecycle w wersji 1.0.1

Wersja 1.0.1

21 lipca 2021 r.

Funkcje androidx.camera:camera-camera2:1.0.1, androidx.camera:camera-core:1.0.1 i androidx.camera:camera-lifecycle:1.0.1 są dostępne. Wersja 1.0.1 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że zwracana przez funkcję ListenableFuture wartość w funkcji setZoomRatio i setLinearZoom nie może zostać wykonana na niektórych urządzeniach z Androidem 11 (I716d7).

• Rozwiązaliśmy problem, który powodował, że na niektórych urządzeniach aparat zacinał się w stanie zamykania i wyświetlał czarny podgląd. (I34c99)

Kamera-Aparat2, rdzeń aparatu i cykl życia kamery w wersji 1.0.0

Wersja 1.0.0

5 maja 2021 roku

Funkcje androidx.camera:camera-camera2:1.0.0, androidx.camera:camera-core:1.0.0 i androidx.camera:camera-lifecycle:1.0.0 są dostępne. Wersja 1.0.0 zawiera te zatwierdzenia.

Najważniejsze funkcje wersji 1.0.0

• CameraX obsługuje Podgląd, ImageCapture i Analysis.
• CameraX zarządza cyklem życia aparatu za pomocą łatwego w użyciu interfejsu API.
• CameraX ma zapewnić warstwę zgodności, która rozwiązuje wiele problemów w ekosystemie aparatów na Androida.

Znane problemy

• Lista znanych problemów

Wersja 1.0.0-rc05

21 kwietnia 2021 r.

Funkcje androidx.camera:camera-camera2:1.0.0-rc05, androidx.camera:camera-core:1.0.0-rc05 i androidx.camera:camera-lifecycle:1.0.0-rc05 są dostępne. Wersja 1.0.0-rc05 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiono błąd, który powodował, że aplikacja ImageCapture z włączoną lub automatyczną lampą błyskową robiła na telefonie Samsung Galaxy S7 wyblakłe zdjęcia. (I30001)

Wersja 1.0.0-rc04

24 marca 2021 r.

androidx.camera:camera-camera2:1.0.0-rc04, androidx.camera:camera-core:1.0.0-rc04 i androidx.camera:camera-lifecycle:1.0.0-rc04 zostały udostępnione. Wersja 1.0.0-rc04 zawiera te zatwierdzenia.

Poprawki błędów

• Poprawiono błąd inicjalizacji na urządzeniach UMIDIGI BISON (I57d9e, b/180818665).

Wersja 1.0.0-rc03

24 lutego 2021 r.

Funkcje androidx.camera:camera-camera2:1.0.0-rc03, androidx.camera:camera-core:1.0.0-rc03 i androidx.camera:camera-lifecycle:1.0.0-rc03 są dostępne. Wersja 1.0.0-rc03 zawiera te zatwierdzenia.

Poprawki błędów

• Popraw błąd formatu w dokumencie ProcessCameraProvider#getInstance
• Usunięto błąd testu Robolectric występujący podczas używania w CameraXConfig metody setAvailableCamerasLimiter.
• Usunięto regresję wydajności ImageCapture przez usunięcie weryfikacji zapisanej lokalizacji obrazu przed zrobieniem zdjęcia. Po wprowadzeniu tej zmiany, jeśli miejsce docelowe zapisu jest nieprawidłowe, otrzymanie odpowiedzi o błędzie zajmie więcej czasu, ponieważ aplikacja będzie próbować zapisać obraz po zrobieniu zdjęcia.
• Ta zmiana przechwytuje wyjątek, gdy kolejka obrazów jest maksymalnie wykorzystana w ImageAnalysis. Zamiast awarii możesz zauważyć inne przypadki zablokowania lub spowolnienia działania, np. zablokowanie lub spowolnienie podglądu.
• obejście problemu polegające na tym, że sporadycznie uszkodzone dane obrazu w pliku JPEG na tylnym aparacie SM-G930T (I52001, b/159831206)
• Ta zmiana wyłapuje wyjątek, gdy kolejka obrazów zostanie wyczerpana w ImageAnalysis. Zamiast awarii może się zdarzyć, że inne przypadki użycia będą działać wolno lub będą zamarzać, np. zamarzanie podglądu. (Ic12da, b/175851631)
• Usunięto błąd testu Robolectric występujący podczas używania w CameraXConfig metody setAvailableCamerasLimiter. (Ice307).
• Usunięto regresję wydajności ImageCapture przez usunięcie weryfikacji zapisanej lokalizacji obrazu przed zrobieniem zdjęcia. Jeśli po wprowadzeniu tej zmiany miejsce zapisu jest nieprawidłowe, odpowiedź o błędzie będzie się pojawiać dłużej, ponieważ aplikacja będzie próbować zapisać obraz po zrobieniu zdjęcia. (I1fd4e, b/177061560)
• Rozwiązano problem regresji wydajności ImageCapture w przypadku typu „Plik” w opcji OutputFileOptions. (I5164a, b/177061560)

Wersja 1.0.0-rc02

27 stycznia 2021 r.

Funkcje androidx.camera:camera-camera2:1.0.0-rc02, androidx.camera:camera-core:1.0.0-rc02 i androidx.camera:camera-lifecycle:1.0.0-rc02 są dostępne. Wersja 1.0.0-rc02 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem z IllegalArgumentException, który występował, gdy wszystkie obsługiwane rozmiary podglądu były mniejsze niż 640 x 480, a rozmiar wyświetlania był większy niż 640 x 480. (b/150506192)

• Ograniczenie liczby prób ponownego otwarcia aparatu. Podczas próby naprawienia niektórych problemów z otwieraniem aparatu aplikacja CameraX nie będzie już próbować ponownie otwierać aparatu w nieskończoność. Zamiast tego zaprzestanie prób po 10 sekundach.I435d2

• Rozwiązaliśmy problem IllegalArgumentException, który występował, gdy wszystkie obsługiwane rozmiary podglądu były mniejsze niż 640 x 480, a rozmiar wyświetlania był większy niż 640 x 480. (I2a63c, b/150506192)

Wersja 1.0.0-rc01

16 grudnia 2020 roku

Funkcje androidx.camera:camera-camera2:1.0.0-rc01, androidx.camera:camera-core:1.0.0-rc01 i androidx.camera:camera-lifecycle:1.0.0-rc01 są dostępne. Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Zmieniono filtry CameraFilter i Camera2Filter tak, aby uwzględniały informacje o aparacie. (I6883d)
• Dodano eksperymentalną klasę Camera2CameraControl, aby umożliwić dynamiczną współpracę z interfejsami API Camera2. (I45cf3)
• Zmieniono nazwę Camera2CameraInfo#fromCameraInfo na #from. (Ia2bd6)
• Dodano eksperymentalny interfejs API setAvailableCamerasLimiter do CameraXConfig, aby umożliwić aplikacjom optymalizację opóźnienia inicjowania przez uniknięcie inicjowania nieużywanych kamer. (I6cf88).
• Dodano metodę eksperymentalną CameraXConfig.Builder#setMinimumLoggingLevel(), która umożliwia ustawienie minimalnego poziomu rejestrowania dzienników w przypadku dzienników CameraX. Jeśli nie jest ustawiony, domyślna wartość to Log#DEBUG. (Ic3245)

Poprawki błędów

• obejście problemu polegające na tym, aby od czasu do czasu uszkodzone dane obrazu w JPEG-ach na tylnym aparacie SM-G930V (I5aca5, b/159831206)
• Rozwiązaliśmy problem, który powodował, że robienie zdjęć nie przynosiło rezultatów, gdy lampa błyskowa była zawsze włączona i otoczenie było ciemne na urządzeniach Samsung SM-A716. (If98b2, b/172036589)
• Rozwiązaliśmy problem polegający na tym, że podglądu nie można było zatrzymać, wywołując funkcję Preview.setSurfaceProvider(null). (I3ac18),
• Rozwiązaliśmy problem z orientacją podczas robienia zdjęć w formacie 4:3 na niektórych urządzeniach. (I0e3fb, b/171492111)

Camera Camera2, Core, & Lifecycle Version 1.0.0-beta12

11 listopada 2020 roku

Funkcje androidx.camera:camera-camera2:1.0.0-beta12, androidx.camera:camera-core:1.0.0-beta12 i androidx.camera:camera-lifecycle:1.0.0-beta12 są dostępne. Wersja 1.0.0-beta12 zawiera te zatwierdzenia.

Poprawki błędów

• Wyłączenie automatycznego flesza na urządzeniach Samsung A3 w celu naprawienia błędu podczas robienia zdjęć w trybie automatycznego flesza AE na urządzeniach Samsung A3. (Ia5fe3, b/157535165)
• Rozwiązaliśmy problem polegający na tym, że podgląd był rozciągnięty na urządzeniach Nexus 4 z Androidem L (poziom interfejsu API 21 i 22). (I4d407, b/158749159)
• Implementacja klasy podstawowej OnImageCapturedCallback#onCaptureSuccess nie zamyka już obrazu. Ma to na celu zapobieganie nieoczekiwanemu zachowaniu programistów. Deweloperzy nie powinni polegać na metodzie super.onCaptureSuccess do zamykania obrazu. (Ifbf9c)
• Wersja androidx adnotacji eksperymentalnej została wycofana, aby zapewnić zgodność z Kotlin. Została ona zastąpiona adnotacją RequiresOptIn, a linter obsługujący język Java został zaktualizowany, aby obsługiwał zarówno nową adnotację Kotlin, jak i nowy wariant androidx. (I52495, b/151331381)

Kamera-Aparat2, wersja 1.0.0-beta11

14 października 2020 r.

androidx.camera:camera-camera2:1.0.0-beta11 został zwolniony. Wersja 1.0.0-beta11 zawiera te zatwierdzenia.

Nowe funkcje

• Obsługuje interfejs API Androida 11 CONTROL_ZOOM_RATIO do powiększania na urządzeniach z Androidem 11 lub nowszym, które zawierają prawidłową wartość CONTROL_ZOOM_RATIO_RANGE. (I62cc6)

Poprawki błędów

• Rozwiązaliśmy problem NumberFormatException, który występował, gdy identyfikator kamery nie był liczbą całkowitą. (Ib2228)
• Krótszy czas oczekiwania na inicjalizację i tworzenie powiązań kameryX (I61dc5)
• Tworzenie przypadków użycia nie wymaga inicjalizacji CameraX. Wszystkie konfiguracje specyficzne dla implementacji są ustawiane w UseCase po dołączeniu do instancji aparatu, która w przypadku publicznego interfejsu API to ProcessCameraProvider.bindToLifecycle(). (Ia5411)
• <UseCase>.getTargetRotation() zwróci Surface.ROTATION_0, jeśli zostanie wywołany przed dołączeniem do instancji Camera, chyba że w Builderze lub UseCase ustawiono wartość targetRotation. (I80fcd)

Camera-Core w wersji 1.0.0-beta11

14 października 2020 r.

Usługa androidx.camera:camera-core:1.0.0-beta11 została zwolniona. Wersja 1.0.0-beta11 zawiera te zatwierdzenia.

Nowe funkcje – Obsługuje interfejs API CONTROL_ZOOM_RATIO Androida w wersji 11 do obsługi powiększenia na urządzeniach z Androidem 11 lub nowszym, który zawiera prawidłową wartość CONTROL_ZOOM_RATIO_RANGE. (I62cc6)

Poprawki błędów

• Naprawiono błąd NumberFormatException, który występował, gdy identyfikator kamery nie był liczbą całkowitą. (IB2228)
• Tworzenie przypadków użycia nie wymaga inicjalizacji CameraX. Wszystkie konfiguracje związane z implementacją są ustawiane w przypadku użycia, gdy jest ona podłączona do instancji kamery, której publiczny interfejs API ma wartość ProcessCameraProvider.bindToLifecycle(). (Ia5411).
• <UseCase>.getTargetRotation() zwróci Surface.ROTATION_0, jeśli zostanie wywołana przed dołączeniem do instancji Camera, chyba że w Builderze lub UseCase ustawiono wartość targetRotation. (I80fcd)

Camera-Core w wersji 1.0.0-beta10

23 września 2020 r.

Usługa androidx.camera:camera-core:1.0.0-beta10 została zwolniona. Wersja 1.0.0-beta10 zawiera te commity.

Poprawki błędów

• Naprawiono błąd w weryfikacji miejsca zapisu pliku podczas przechwytywania obrazu (I8c565, b/167697553).

Camera-Camera2 wersja 1.0.0-beta10

23 września 2020 r.

androidx.camera:camera-camera2:1.0.0-beta10 został zwolniony. Wersja 1.0.0-beta10 zawiera te zatwierdzenia.

Poprawki błędów

• Wersja obsługująca Camera-Core 1.0.0-beta10

Camera-Camera2 Version 1.0.0-beta09

16 września 2020 roku

androidx.camera:camera-camera2:1.0.0-beta09 został zwolniony. Wersja 1.0.0-beta09 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Zamiast statycznych metod Camera2CameraInfo używa instancji CameraInfo, aby pobrać informacje związane z Camera2. (I5b844)

Poprawki błędów

• Rozwiązano problem z formatem obrazu docelowego na urządzeniach typu tablet. Jeśli docelowy format obrazu jest ustawiony jako AspectRatio.RATIO_16_9, należy wybrać rozmiar 16:9. (Ib7fcf, b/151969438)
• Wywołaj InitializationException, aby aplikacja mogła prawidłowo obsłużyć błąd AssertionError występujący podczas tworzenia obiektu CameraCharacteristics. (I89c8c, b/160524721)
• Dodane eksperymentalne interfejsy kompensacji ekspozycji (If96c7)

Camera-Core w wersji 1.0.0-beta09

16 września 2020 roku

androidx.camera:camera-core:1.0.0-beta09 został zwolniony. Wersja 1.0.0-beta09 zawiera te commity.

Zmiany w interfejsie API

• Naprawiono błąd, który powodował, że widoczny obszar był oznaczony jako niepusty w przypadku grupy UseCaseGroup. Deweloperzy powinni mieć możliwość tworzenia widoku bez ustawiania widoku. (Ie3d2e)
• Dodano eksperymentalne interfejsy dla ExposureCompensation (If96c7)
• Zezwalanie na dowolny obrót obiektu w podglądzie. Informacje o przekształceniu są obliczane i zwracane użytkownikowi w locie za pomocą nowego wywołania zwrotnego TranformationInfoListener. (I21470)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że lampka błyskowa na niektórych urządzeniach nie wyłączała się. Dzieje się tak, gdy tryb lampy błyskowej jest ustawiony na FLASH_MODE_ON, aby zrobić zdjęcie, a po jego zrobieniu zmienia się na FLASH_MODE_OFF. Objawy są podobne do włączenia trybu latarki. (Ib4451, b/162568128)
• Wymuszenie PreviewView do użycia TextureView, jeśli włączony jest efekt rozszerzenia, a implementacja biblioteki dostawcy wymaga specjalnego przetwarzania powierzchni wyjściowej. (I0c3cc).
• Rozwiązaliśmy problem z wyciekiem aktywności/fragmentu, gdy kontekst aktywności/fragmentu jest przekazywany do ProcessCameraProvider.getInstance(Context).

Znane problemy

• Gdy ustawisz ViewPort, prostokąt przycinania w ImageCapture może być nieprawidłowy na urządzeniach, które obracają bufor obrazu w HAL. Naprawimy to w kolejne wersji.

Camera-Camera2 Wersja 1.0.0-beta08

19 sierpnia 2020 r.

androidx.camera:camera-camera2:1.0.0-beta08 został zwolniony. Wersja 1.0.0-beta08 zawiera te commity.

Poprawki błędów

• Zoptymalizowano bindToLifecycle, aby działał szybko w wątku głównym. (I1d57e)
• DisplayOrientedMeteringPointFactory wykorzystuje instancję CameraInfo zamiast obiektu CameraSelector, dzięki czemu istnieje bezpośrednie mapowanie na kamerę, dla której fabryka będzie generować punkty. Wszystkie klasy, które korzystają z DisplayOrientedMeteringPointFactory, przyjmują też instancję CameraInfo zamiast CameraSelector. (I400c1)
• Rozwiązano problem z grupowaniem rozmiarów o współczynniku proporcji automatycznej rozdzielczości, gdy przy ustawieniu docelowym 2016 x 1080 i innym obsługiwanym rozmiarze 1920 x 1080 16:9 wybrano rozmiar 16:9 mod16 (864 x 480). (I53167, b/159363774)
• Rozwiąż problem z funkcją CameraControl, który uniemożliwia działanie ze względu na warunki wyścigowe (I2279f, b/152333890, b/160714166)

Camera-Core w wersji 1.0.0-beta08

19 sierpnia 2020 r.

androidx.camera:camera-core:1.0.0-beta08 został zwolniony. Wersja 1.0.0-beta08 zawiera te commity.

Zmiany w interfejsie API

• Funkcja DisplayOrientedMeteringPointFactory pobiera instancję CameraInfo zamiast CameraSelector, więc istnieje bezpośrednie mapowanie na kamerę, dla której fabryka będzie generować punkty. Wszystkie klasy, które używają DisplayOrientedMeteringPointFactory, przyjmują też instancję CameraInfo zamiast CameraSelector. (I400C1)

Poprawki błędów

• W przypadku przechwytywania obrazu zastąp flagę „odwróć w poziomie” w metadanych odpowiednio do kierunku aparatu. (I28499)
• Inicjowanie nie powinno już powodować awarii, gdy używasz kontekstu, który nie zwraca obiektu Application z Context.getApplicationContext(). (I3d3c9, b/160817073)

Kamera-Aparat2 w wersji 1.0.0-beta07

22 lipca 2020 r.

androidx.camera:camera-camera2:1.0.0-beta07 został zwolniony. Wersja 1.0.0-beta07 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że podgląd jest rozciągnięty na starszych urządzeniach z Androidem 5.0. (I0c03a)
• Wykluczono niektóre obsługiwane rozmiary JPEG, które na niektórych urządzeniach powodują problemy z WYSIWYG. (Ib5128)

Camera-Core w wersji 1.0.0-beta07

22 lipca 2020 r.

androidx.camera:camera-core:1.0.0-beta07 został zwolniony. Wersja 1.0.0-beta07 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Scal styl FIT_CENTER, FIT_START i FIT_END z FIT. FIToznacza, że zwrócony prostokąt przycinania będzie maksymalnym możliwym prostokątem czujnika. (Ia73c3)
• Prostokąt przycinania podglądu jest konfigurowany przez widoczny obszar. Użytkownicy powinni widzieć tylko obszar określony przez prostokąt przycinania. (I142a4)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że podgląd jest rozciągnięty na starszych urządzeniach z Androidem 5.0. (I0c03a)
• Rozwiązaliśmy problem z wyjątkiem ConcurrentModificationException, który występował podczas usuwania powiązań przypadków użycia. (I371c0)

Aparat-Aparat2 w wersji 1.0.0-beta06

24 czerwca 2020 r.

androidx.camera:camera-camera2:1.0.0-beta06 został zwolniony. Wersja 1.0.0-beta06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano eksperymentalne interfejsy do filtrowania kamer według identyfikatora kamery i właściwości CameraCharacteristics. (I28f61)

Poprawki błędów

• Rozwiązaliśmy problem, który powodował, że na telefonie Samsung Galaxy S7 funkcja startFocusAndMetering nie mogła ustawić ostrości. (If3be7, b/159039233)
• Naprawianie problemów z zamknięciem aparatu po zamknięciu aplikacji (I7a7b3)
• Poprawianie powtarzających się podglądu przerw na przełączanie kamery podczas korzystania z implementacji funkcji PreviewView SurfaceView (I920ce)
• CameraControl#startFocusAndMetering zakończy się niepowodzeniem, jeśli żaden z podanych punktów pomiarowych nie może wygenerować prawidłowych prostokątów pomiarowych. (Id53ce)

Camera-Core Version 1.0.0-beta06

24 czerwca 2020 r.

Usługa androidx.camera:camera-core:1.0.0-beta06 została zwolniona. Wersja 1.0.0-beta06 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodano eksperymentalne interfejsy do filtrowania kamer według identyfikatora kamery i właściwości CameraCharacteristics. (I28f61)

Poprawki błędów

• Aplikację CameraX można teraz skonfigurować za pomocą interfejsu ProcessCameraProvider#configureInstance() przed wywołaniem interfejsu ProcessCameraProvider#getInstance(). Umożliwia to dostosowanie CameraXConfig bez konieczności implementowania CameraXConfig.Provider w klasie Application aplikacji. (Ia1a8d)
• CameraControl#startFocusAndMetering zakończy się niepowodzeniem, jeśli żaden z podanych punktów pomiarowych nie będzie mógł wygenerować prawidłowych prostokątów pomiarowych. (Id53ce)

Camera-Camera2 Version 1.0.0-beta05

10 czerwca 2020 r.

androidx.camera:camera-camera2:1.0.0-beta05 został zwolniony. Wersja 1.0.0-beta05 zawiera te commity.

Poprawki błędów

• Rozwiązanie problemu z zawieszaniem się aplikacji podczas inicjowania CameraX, gdy telefon jest w trybie Nie przeszkadzać. InitializationException zawiera CameraUnavailableException, który zostanie ustawiony na ListenableFuture wyniku inicjalizacji zamiast powodować awarię aplikacji. (I9909a, b/149413835)
• Usunięto awarię podczas wywoływania funkcji startFocusAndMeteringna urządzeniach, na których wartość CONTROL_AF_STATE jest pusta. (Ife55e, b/157084254)

Camera-Core w wersji 1.0.0-beta05

10 czerwca 2020 r.

androidx.camera:camera-core:1.0.0-beta05 został zwolniony. Wersja 1.0.0-beta05 zawiera te commity.

Zmiany w interfejsie API

• Naprawianie awarii przy uruchamianiu aplikacji podczas inicjowania aplikacji CameraX, gdy telefon jest w trybie Nie przeszkadzać. Jeśli InitializationException zawiera CameraUnavailableException, zostanie ono ustawione na ListenableFuture wyniku inicjalizacji zamiast powodować zamykanie aplikacji. (I9909a, b/149413835)

Poprawki błędów

• Zaktualizowano dokumentację Java docs setTargetResolution i setTargetRotation. (Iae16f)

Camera-Camera2 Version 1.0.0-beta04

27 maja 2020 r.

Usługa androidx.camera:camera-camera2:1.0.0-beta04 została zwolniona. Wersja 1.0.0-beta04 zawiera te zatwierdzenia.

Poprawki błędów

• Zezwolono aplikacjom na ustawianie dowolnych parametrów żądań przechwytywania Camera2 za pomocą interfejsu Camera2Interop bez wywoływania awarii. Pamiętaj, że jeśli wystąpią problemy z następczymi parametrami, Stabilność i zachowanie nie są gwarantowane, gdy zastąpisz parametry za pomocą Camera2Interop. (Ibe5a1, b/149103700)
• Naprawiono automatyczną inicjalizację podczas korzystania z aplikacji na urządzeniu, które używa pseudolokalizacji. (I3bef3, b/154767663)
• Przekształcono dziennik błędów związany z oddzielonym przypadkiem użycia w dziennik debugowania w Camera2CameraImpl. (I1a565, b/154422490)
• Rozwiązaliśmy problem polegający na tym, że zdjęcie było czasem zbyt ciemne, mimo że z użyciem lampy błyskowej. (I5d9fa, b/149729613)
• Naprawianie błędu polegającego na tym, że bufor w pliku ImageProxy z pliku ImageCapture nie był przewinięty (I0c455, b/153249512)
• Naprawiono problemy, które powodowały, że tylko łączenie funkcji ImageCapture: (1) Nie udało się zrobić zdjęć z parametrem MAX_QUALITY; (2) Wygenerowano niską jakość zdjęcia, ponieważ nie działa automatyczna ekspozycja. (I17782, b/145326998)
• Zwiększona niezawodność ponownego otwierania aparatu, gdy CameraX zostanie odłączony przez inny proces lub ścieżkę kodu, która przechwytuje aparat (I1fbc3, b/153714651)

Camera-Core Wersja 1.0.0-beta04

27 maja 2020 r.

Usługa androidx.camera:camera-core:1.0.0-beta04 została zwolniona. Wersja 1.0.0-beta04 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaje eksperymentalny interfejs API CameraXConfig.Builder#setSchedulerHandler() do ustawiania modułu obsługi używanego wewnętrznie przez pakiet aparatu CameraX. Ten nowy interfejs API wraz z interfejsem CameraXConfig.Builder#setCameraExecutor() powinien zapewniać pełną kontrolę nad wątkami używanymi przez pakiet aparatu CameraX. (I7bf32, b/121160431)

Poprawki błędów

• Naprawiono błąd powodujący awarię w funkcji ImageAnalysis, gdy użytkownik uzyskuje dostęp do funkcji ImageProxy po zamknięciu funkcji ImageReaderProxy. Dzięki temu wszystkie ImageProxy odebrane przez Analyzer muszą zostać zamknięte przed zamknięciem ImageReaderProxy. (I4b299, b/145956416, b/154155377, b/156357269)
• Parametr CameraInfo został usunięty z funkcji PreviewView#createSurfaceProvider(), a funkcja PreviewView pobiera go teraz wewnętrznie z funkcji SurfaceRequest. (If18f0, b/154652477)
• Naprawiono automatyczne inicjowanie w przypadku korzystania z aplikacji na urządzeniu z pseudojęzykiem. (I3bef3, b/154767663)
• Rozwiązaliśmy problem polegający na tym, że czasami zdjęcie było zbyt ciemne, mimo że włączono lampę błyskową. (I5d9fa, b/149729613)
• Naprawiono błąd z funkcją ImageAnalysis, w którym wielokrotne wywołania funkcji setAnalizujr/clear Analysisr powodowały, że analizator nie odbierał obrazów do analizy. (I6169f, b/151605317, b/153514544)
• Usunięto błąd, który powodował, że bufor w ImageProxy z ImageCapture nie był przewijany (I0c455, b/153249512)
• Rozwiązaliśmy problem, który powodował, że pierwsza kamera na obsługiwanej liście z usługi CameraManager nie zawsze była wybrana do użycia. (I4c624, b/153418028)
• Rozwiązano problem z nieregularnym awariami spowodowanymi przez ustawienie Preview.SurfaceProvider, które nie zwalniało wcześniej żądanej powierzchni. “java.lang.IllegalStateException: Camera surface session should only fail with request cancellation” (I8e4e7, b/155936225)

Camera-Camera2 Wersja 1.0.0-beta03

15 kwietnia 2020 roku

Usługa androidx.camera:camera-camera2:1.0.0-beta03 została zwolniona. Wersja 1.0.0-beta03 zawiera te komitowane zmiany.

Poprawki błędów

• Poprawki umożliwiające wydanie camera-core

Camera-Core Wersja 1.0.0-beta03

15 kwietnia 2020 roku

Usługa androidx.camera:camera-core:1.0.0-beta03 została zwolniona. Wersja 1.0.0-beta03 zawiera te zatwierdzenia.

Poprawki błędów

• Naprawiliśmy regresję z wersji beta03, w której wywołanie funkcji bindToLifecycle() z zerową wartością UseCase powodowało zgłoszenie zgłoszenia. Uniemożliwiło to pobranie elementu Camera bez powiązania UseCase.

Camera-Camera2 wersja 1.0.0-beta02

1 kwietnia 2020 r.

androidx.camera:camera-camera2:1.0.0-beta02 został zwolniony. Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

• Poprawiliśmy wartość ImageInfo.getRotationDegrees() z ImageProxy wygenerowanego przez ImageCapture, tak aby pasowała do wartości obrotu orientacji EXIF. (Id4281, b/150802561)
• Aby używać domyślnej implementacji CameraX/Camera2, nie jest już wymagane jawne uporządkowanie zależności CameraX w build.gradle. W przypadku konieczności zadeklarowania ścisłych zależności wszystkie zależności CameraX można teraz uwzględnić w pliku kompilacji. (I46e88)
• Rozwiązaliśmy problem IllegalArgumentExceptionwystępujący na urządzeniach, na których rozmiar wyświetlacza jest mniejszy niż 640 x 480. (Ife3f2, b/150506192)
• Naprawiono funkcję bindToLifecycle, tak aby modyfikowała ona tylko UseCase, jeśli udało się ją powiązać. Wcześniej, gdy wywoływana była funkcja bindToLifecycle w celu wykonania obliczeń rozdzielczości, była aktualizowana zmienna UseCase. Teraz do wykonania obliczeń nie trzeba już aktualizować UseCase (I78d9e)

Wersja 1.0.0-beta02 systemu kamery

1 kwietnia 2020 r.

androidx.camera:camera-core:1.0.0-beta02 został zwolniony. Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

• Poprawiliśmy wartość ImageInfo.getRotationDegrees() z ImageProxy wygenerowanego przez ImageCapture, tak aby pasowała do wartości obrotu orientacji EXIF. (Id4281, b/150802561)
• Naprawiliśmy błąd bindToLifecycle, dzięki czemu zmienia się przypadek użycia tylko wtedy, gdy udało się go powiązać. Wcześniej, gdy wywoływana była funkcja bindToLifecycle w celu wykonania obliczeń rozdzielczości, była aktualizowana zmienna UseCase. Teraz do wykonania obliczeń nie trzeba już aktualizować UseCase (I78d9e)
• Rozwiązaliśmy problem, który powodował, że sesja przechwytywania przypadku użycia Preview nie była aktualizowana, gdy powierzchnia podglądu zmieniła się po więcej niż jednym wywołaniu funkcji Preview.setSurfaceProvider().

Aparat – Camera2 w wersji 1.0.0-beta01

26 lutego 2020 r.

androidx.camera:camera-camera2:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

Poprawki błędów

• Zmieniono nazwę SurfaceRequest.setSurface(Surface) na SurfaceRequest.provideSurface(Surface), a SurfaceRequest.setWillNotComplete() na SurfaceRequest.willNotProvideSurface(). (I224fe)
• Rozwiązanie problemu polegającego na tym, że po zmianie wartości docelowej obrotu za pomocą ImageCapture.setTargetRotation() nieprawidłowy był format zapisywanego obrazu. (I474ea, b/148763432)
• Naprawiono inicjowanie wariantów aplikacji z włączoną funkcją ProGuard przez zachowanie flagi ustawiającej domyślnego dostawcę CameraXConfig. (I2d6c1)

Camera-Core w wersji 1.0.0-beta01

26 lutego 2020 r.

androidx.camera:camera-core:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

Zmiany w interfejsie API

• Zawartość komórki ListenableFuture w kolumnie SurfaceRequest.provideSurface() została zastąpiona przez Executor i Callback. Upraszcza to interfejs API, ponieważ nie wymaga już obsługi wyjątków w przypadku provideSurface() i zapewnia, że wywołania zwrotnego provideSurface() nie można anulować. Ma to zapobiegać awariom na starszych urządzeniach spowodowanym przez przedwczesne zwalnianie powierzchni. Obiekt SurfaceRequest.Result jest teraz używany do śledzenia sposobu korzystania przez SurfaceRequest z podawanego obiektu Surface. (I7854b)
• Zmieniono nazwę SurfaceRequest.setSurface(Surface) na SurfaceRequest.provideSurface(Surface), a SurfaceRequest.setWillNotComplete() na SurfaceRequest.willNotProvideSurface(). (I224fe)

Poprawki błędów

• Rozwiązanie problemu polegającego na tym, że po zmianie wartości docelowej obrotu za pomocą ImageCapture.setTargetRotation() nieprawidłowy był format zapisywanego obrazu. (I474ea, b/148763432)
• Naprawiono błąd inicjowania wariantów aplikacji z włączonym ProGuardem, zachowując flagę, która ustawia domyślnego dostawcę CameraXConfig. (I2d6c1)
• Zaktualizowaliśmy dokumentację interfejsów API trybu flash, aby uwzględnić możliwe wartości. (I4a3ec)

Aparat – Camera2, wersja 1.0.0-alpha10

10 lutego 2020 r.

androidx.camera:camera-camera2:1.0.0-alpha10 został zwolniony. Wersja 1.0.0-alfa10 zawiera te zatwierdzenia.

Poprawki błędów

• Zwiększono stabilność na urządzeniach z systemem INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY, ponieważ elementy Surface są zachowywane tylko przez cały czas ich używania przez Aparat 2. (I9dac2)
• Rozwiązanie problemu z podglądem na urządzeniach POZOSTARZECZONYCH polegającego na niedoświetleniu obrazu. Rozwiązanie polega na prawidłowym dostosowaniu CONTROL_AE_TARGET_FPS_RANGE. (1224638)

Camera-Core Wersja 1.0.0-alpha10

10 lutego 2020 r.

androidx.camera:camera-core:1.0.0-alpha10 został zwolniony. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia:

Zmiany w interfejsie API

• Zaktualizowano ImageCapture, aby zezwolić na zapisywanie obrazów w usługach Uri i OutputStream. Połączone przeciążone metody takePicture w jedną. Zaktualizowano aplikację testową, aby używała Uri jako przykładu kanonicznego. (Ia3bec).
• Nazwa Preview.PreviewSurfaceProvider została zmieniona na Preview.SurfaceProvider. SurfaceProvider nie wymagają już od programistów tworzenia własnych obiektów ListenableFuture, a polecenie Surface odbywa się teraz za pomocą nowego obiektu SurfaceRequest. Metoda Preview.getPreviewSurfaceProvider() została usunięta z powodu nieprawidłowego użycia, gdy klasa Preview jest sparowana z innymi klasami, takimi jak PreviewView. (I20105)
• Dodano getTargetRotation() i getTargetName() do listy Preview. (Iceee7)
• Dodano użytkowników getTargetRotation(), getBackpressureStrategy() i getImageQueueDepth() do albumu ImageAnalysis. (I9d6d9)
• Dodano getTargetRotation() i getCaptureMode() w ImageCapture() (I5bc17)
• Argumenty, które były wcześniej przekazywane w parametrach ImageCapture.OnImageSavedCallback.onError() i ImageCapture.OnImageCapturedCallback.onError(), zostały zastąpione przez pojedynczy argument ImageCaptureException, który nadal zawiera wszystkie informacje, które były przekazywane wcześniej.
• Argument pliku, który był wcześniej przekazywany w parametry ImageCapture.OnImageSavedCallback.onImageSaved(), został usunięty. (I750d2)
• Zajęcia Preview i ImageCapture są teraz oznaczone jako ostateczne. (I2500b)
• Interfejs API został zaktualizowany. Metody getZoomRatio(), getMaxZoomRatio(), getMinZoomRatio() i getLinearZoom() interfejsu CameraInfo zostały połączone w interfejs getZoomState(), który zwraca instancję ZoomState. (IB19fe)
• Usunięto pola interfejsu API OPTION_TARGET_CLASS i OPTION_TARGET_NAME z CameraXConfig, ponieważ są one przeznaczone tylko do użytku wewnętrznego. Usunięto konstruktor dla CameraXConfig.Builder. (I96912)
• Usunięto wymóg, że aplikacja musi rozszerzać klasę Application, aby zainicjować CameraX. CameraX będzie teraz inicjowana za pomocą domyślnej konfiguracji Camera2, o ile element camera-camera2 jest uwzględniony w build.gradle aplikacji. (I58ff5) (b/146923574)

Aparat-Aparat2 w wersji 1.0.0-alpha09

22 stycznia 2020 r.

androidx.camera:camera-camera2:1.0.0-alpha09 został zwolniony. Wersja 1.0.0-alfa09 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodaj ścieżkę interoperacyjności Camera2 do wyodrębniania identyfikatora aparatu Camera2. Identyfikator aparatu możesz wyodrębnić z CameraInfo za pomocą funkcji Camera2CameraInfo.extractCameraId(). Poniższy przykładowy kod pokazuje, jak tego użyć:

  Camera camera = provider.bindToLifecycle(...);
  String cameraId =
      Camera2CameraInfo.extractCameraId(camera.getCameraInfo());
  

  Klasa Camera2CameraInfo wymaga parametru ExperimentalCamera2InteropmarkerClass.

Camera-Core w wersji 1.0.0-alpha09

Styczeń 22, 2020

androidx.camera:camera-core:1.0.0-alpha09 został zwolniony. Wersja 1.0.0-alfa09 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Parametr SurfaceOrientedMeteringPointFactory useCaseForSurface został przemianowany na useCaseForAspectRatio, a dokumentacja referencyjna została rozszerzona.
• Metody FocusMeteringAction.Builder.from() są zastępowane przez konstruktory FocusMeteringAction.Builder().
• Usunięto DisplayOrientedMeteringPointFactory(android.content.Context, androidx.camera.core.CameraSelector, float, float). Aplikacje powinny używać konstruktora, który przyjmuje parametr Display i przekazuje w bieżącym widoku.
• Ulepszenia w dokumentacji Javadoc interfejsów API do pomiarów i koncentracji dotyczące flag MeteringMode i 3A oraz użycia parametru Display.
• Rozwinęliśmy dokumentację referencyjną dotyczącą setZoomRatio i setLinearZoom.

Poprawki błędów

• Rozwiązaliśmy problemy z zamykaniem i otwieraniem kamer, które powodowały niepowodzenie podczas sprawdzania stanu wstępnego.
• Rozwiązaliśmy błąd ConcurrentModificationException, który mógł występować podczas używania interfejsów API latarki i zoomu.
• Rozwiązaliśmy problem polegający na tym, że w przypadku dostępnych wymiarów mod16 rozmiary były wybierane zamiast żądanej rozdzielczości.
• Interfejsy API startFocusMetering i cancelFocusMetering działają teraz zgodnie z dokumentacją, z prawidłowym czasem i możliwym zwracaniem błędów.
• Rozwiązanie problemu, który występował, gdy na urządzeniu, które nie obsługuje takich rozmiarów, żądano określonej rozdzielczości docelowej ze współczynnikiem proporcji przycinania. Teraz, gdy będzie dostępne, zostanie wybrany nieprzycięty rozmiar o wystarczającej rozdzielczości do powiązania pierwotnego żądania.

Camera-Camera2 Version 1.0.0-alpha08

18 grudnia 2019 r.

androidx.camera:camera-camera2:1.0.0-alpha08 został zwolniony. Wersja 1.0.0-alpha08 zawiera te zatwierdzenia

Znane problemy

• Nie wszystkie opcje żądania przechwycenia Camera2 działają podczas korzystania z interoperacyjności Camera2. Jeśli żądana opcja nie jest obsługiwana, sesja nie rozpocznie się i może wystąpić taki komunikat o błędzie: 09-09 14:04:13.643 10117 26020 26036 E AndroidRuntime: java.lang.IllegalArgumentException: Unsupported session configuration combination

Poprawki błędów

• Naprawiono błąd, który powodował, że po obróceniu lub przełączeniu kamery na podglądzie z poziomem API na poziomie 21 i 22 pojawiał się czarny ekran.

Zmiany w interfejsie API

• Experimental: dodano ścieżkę interoperacyjności camera2 do wyodrębniania identyfikatora aparatu.

Camera-Core w wersji 1.0.0-alpha08

18 grudnia 2019 r.

androidx.camera:camera-core:1.0.0-alpha08 został zwolniony. Wersja 1.0.0-alpha08 zawiera te zatwierdzenia

Znane problemy

• Aplikacje korzystające z formatu PreviewView lub CameraView mogą mieć nieprawidłowy podgląd w formacie obrazu. Dzieje się tak po wstrzymaniu lub wznowieniu na niektórych urządzeniach z pełną obsługą, takich jak Pixel 2.

Poprawki błędów

• Zaktualizowaliśmy dokumentację dotyczącą usług FocusMeteringAction i CameraControl.
• Wdrożono TorchControl w przypadku metod enableTorch() i getTorchState().

Zmiany w interfejsie API

• Ukryto wartości IntDef i przesunęliśmy stałe IntDef poza definicję IntDef.
• Element sterujący rotationDegrees został przeniesiony z klasy OnImageCaptureCallback do klasy ImageInfo.
• Element sterujący rotationDegrees został przeniesiony z klasy Analyzer do klasy ImageInfo.

Aparat-Aparat2 w wersji 1.0.0-alpha07

4 grudnia 2019

androidx.camera:camera-camera2:1.0.0-alpha07 został zwolniony. Wersja 1.0.0-alfa07 kamery Camera-camera2 zawiera te zatwierdzenia

• Camera2Config jest teraz dostępny do inicjowania i konfigurowania implementacji Camera2 w CameraX. Więcej informacji o korzystaniu z tej funkcji do inicjowania znajdziesz w sekcji dotyczącej rdzenia aparatu w informacjach o wersji.
• Funkcja interoperacyjności w camera2 jest teraz oznaczona jako eksperymentalna i przeniesiona do osobnego pakietu, androidx.camera.camera2.interop.

Camera-Core w wersji 1.0.0-alpha07

4 grudnia 2019

androidx.camera:camera-core:1.0.0-alpha07 został zwolniony. Wersja 1.0.0-alpha07 pakietu camera-core zawiera te zatwierdzenia

Pamiętaj, że w tej wersji alpha są pewne istotne zmiany, ponieważ przygotowujemy się do wydania wersji beta. Zalecamy zapoznanie się ze zmianami i przesłanie opinii na temat grupy CameraX w Google. Deweloperom, którzy używają CameraX w aplikacjach w Google Play, zalecamy zaczekanie na oficjalną wersję beta, zanim zaktualizują bibliotekę w swoich aplikacjach.

Zmiany interfejsu API

• Ważne: procedura inicjowania CameraX uległa zmianie. Aplikacje powinny implementować CameraXConfig.Provider i używać domyślnego Camera2Config udostępnianego przez androidx.camera.camera2. Typowe zastosowanie:

  import androidx.camera.camera2.Camera2Config
  import androidx.camera.core.CameraXConfig
  
  public class MyCameraXApplication : Application(),  CameraXConfig.Provider {
      override fun getCameraXConfig(): CameraXConfig {
              return Camera2Config.defaultConfig(this)
      }
  }
  

• Klasa CameraX została usunięta. Parametry bindToLifecycle(), unbind(), unbindAll(), isBound() i hasCamera(), które wcześniej były dostępne w ramach wywołania klasy CameraX, są teraz dostępne w ProcessCameraProvider.

• instancja ProcessCameraProvider dla każdego procesu jest uzyskiwana asynchronicznie za pomocą metody statycznej ProcessCameraProvider.getInstance(), która zwraca przyszłość do słuchania, która dostarcza ProcessCameraProvider po zakończeniu. Tutaj jest on pokazany w onCreate() w typowym przypadku. Możesz wywoływać funkcję getInstance() w późniejszym etapie cyklu aktywności, aby opóźnić opóźnienie inicjalizacji (np. gdy działanie użytkownika powoduje otwarcie interfejsu aparatu).

  import androidx.camera.lifecycle.ProcessCameraProvider
  import com.google.common.util.concurrent.ListenableFuture
  
  class MainActivity : AppCompatActivity() {
     private lateinit var cameraProviderFuture : ListenableFuture<ProcessCameraProvider>
     override fun onCreate(savedInstanceState: Bundle?) {
         cameraProviderFuture = ProcessCameraProvider.getInstance(this);
    }
  

• Słuchacza można dodać do ListenableFuture zwróconego przez getInstance(). Dzięki temu dostawcę kamery można pobrać z Future bez blokowania na Future.get()

  cameraProviderFuture.addListener(Runnable {
    val cameraProvider = cameraProviderFuture.get()
    cameraProvider.bindToLifecycle(...)
  }, ContextCompat.getMainExecutor(this))
  

• Wybór kamery odbywa się teraz za pomocą selektora aparatu, a nie konkretnego przypadku użycia

  val cameraSelector = CameraSelector.Builder().requireLensFacing(LensFacing.BACK).build()
  

• CameraProvider.bindToLifecycle ma właściciela cyklu życia, selektor kamery i przypadki użycia, które są następnie powiązane z danym właścicielem cyklu życia i uruchamiane w przypadku wybranej kamery.

  cameraProvider.bindToLifecycle(this as LifecycleOwner,
         cameraSelector, preview, imageAnalysis)
  

• Usunięto klasy „Config” (przypadek użycia). Zamiast tego twórz przypadki użycia bezpośrednio i konfigurując opcje w każdym kreatorze przypadków użycia. Na przykład:

  preview = Preview.Builder().setTargetAspectRatio(AspectRatio.RATIO_16_9).build()
  

• Przypadek użycia wersji testowej został zaktualizowany, aby akceptował platformę utworzoną i zarządzaną przez aplikację, co zapewnia zgodność ze sprawdzonymi metodami dotyczącymi Androida. Zdecydowanie zalecamy użycie klasy widoku PreviewView, która jest dostępna w pakiecie widoku kamery.

  preview.setPreviewSurfaceProvider(previewView.previewSurfaceProvider)
  

• Zapoznaj się z dokumentacją dotyczącą dołączania powierzchni zarządzanej przez aplikację. W takich przypadkach aplikacja zarządza cyklem życia powierzchni.

• Ważne: implementacja metody ImageAnalysis w analizatorze musi wywołać funkcję image.close() po zakończeniu korzystania z otrzymanych obrazów. W przeciwnym razie nowe obrazy mogą nie być odbierane lub kamera może się zatrzymać (w zależności od ustawienia ciśnienia wstecznego). Szczegółowe informacje znajdziesz w dokumentacji referencyjnej.

• Strategia ImageAnalysis ImageReaderMode została teraz zmieniona na strategię intdef.

• ImageProxy.getImage() jest oznaczone jako eksperymentalne. Aplikacje powinny zawierać adnotacje dotyczące użycia, np. @androidx.camera.core.ExperimentalGetImage

• Wymaganie adnotacji UIThread w przypadku Analyzer zostało usunięte.

• Funkcja ImageAnalysis.clearAnalyzer() została dodana w celu usunięcia analizatora.

• Listenery z większą liczbą metod zostały przemianowane na wywołania zwrotne:

  • ImageCapture.OnImageCapturedListener to teraz ImageCapture.OnImageCapturedCallback
  • ImageCapture.OnImageSavedListener to teraz ImageCapture.OnImageSavedCallback
  • VideoCapture.OnVideoSavedListener to teraz VideoCapture.OnVideoSavedCallback

• Typy enumeracji zostały zmienione na IntDef

• Dodaliśmy elementy sterujące powiększeniem:

  • CameraControl.setLinearZoom()
  • CameraControl.setZoomRatio()
  • CameraInfo.getLinearZoom()
  • CameraInfo.getMaxZoomRatio()
  • CameraInfo.getZoomRatio()

• CameraInfo.hasFlashUnit() jest dodawane, aby określić, czy sprzęt do obsługi lampy błyskowej lub latarki jest obecny.

• CameraInfo.isFlashAvailable() został(a) usunięty(a). Funkcja latarki zastępuje funkcję lampy błyskowej. Więcej informacji znajdziesz w dokumentacji referencyjnej.

• Pola ImageCapture.Metadata są zastępowane przez metody dostępu get/set/is.

• Funkcje startFocusMetering i cancelFocusMetering zwracają teraz wartość ListenableFutures, która reprezentuje asynchroniczną operację wywołania.

• MeteringPoints działają teraz jako uchwyty do pomiarowych działań i są produkowane przez fabryki. Aplikacje powinny korzystać z dotychczasowych fabryk, a nie z niestandardowych.

Rozwiązane problemy

• Rozwiązaliśmy problem z robieniem zdjęć po wznowieniu (po poprzedniej przerwie w robieniu zdjęć).
• Znany problem: CameraControl.enableTorch() działa, ale zwrócona wartość ListenableFuture<Void> jest zawsze przyszłą datą complete(success), nawet jeśli nie ma jednostki Flash. W przyszłych wersjach to zachowanie zostanie zmienione. Gdy nie ma modułu lampy błyskowej, enableTorch(true) od razu się nie powiedzie (nie wyśle żądania do CaptureSession), a TorchState pozostanie wyłączone.
• Znane problemy: funkcje startFocusAndMetering i cancelFocusAndMetering uruchamiają i anulują pomiar ostrości, ale zwracają natychmiastową wartość completed (success), która nie odpowiada opisanemu działaniu. Parametr FocusMeteringResult z ListenableFuture<FocusMeteringResult> CameraControl.startFocusAndMetering() to fałszywy wynik, który jest isFocusSuccessful() i zawsze ma wartość „false” (fałsz). Jest to niezgodne z zamierzonym, udokumentowanym działaniem.
• Znane problemy: trwa tworzenie fabryki punktów pomiarowych do użytku w przypadku zdarzeń styczności z klientem typu PreviewView. Obecnie aplikacje łączące niestandardowe powierzchnie zarządzane mogą używać istniejących fabryk punktów pomiarowych. W innych przypadkach funkcja skupienia dotykiem nie jest dostępna dla PreviewView.

Camera-Camera2 i Camera-Core w wersji 1.0.0-alpha06

9 października 2019 r.

androidx.camera:camera-camera2:1.0.0-alpha06 i androidx.camera:camera-core:1.0.0-alpha06 zostały udostępnione. Oto kompilacje uwzględnione w camera-camera2:1.0.0-alpha06 i kompilacje uwzględnione w camera-core:1.0.0-alpha06.

Nowe funkcje

Zmiany w ustawieniach formatu obrazu:

• Dodano metodę setTargetAspectRatioMode(), która akceptuje argument typu enum. Spowoduje to ustawienie trybu proporcji obrazu za pomocą opcji RATIO_4_3 lub RATIO_16_9 zamiast dowolnych proporcji. Ta funkcja uwzględnia fakt, że z kamery pochodzą tylko określone formaty obrazu, a nie dowolne.
  • Obecnie dostępne są tylko formaty 16:9 i 4:3. W przypadku formatu 1:1 tylko niektóre urządzenia mają dostęp do kamery, a w tym przypadku tylko w ograniczonych rozdzielczościach. Aplikacje projektujące interfejs lub przetwarzanie o proporcjach 1:1 powinny korzystać z bardziej elastycznych opcji formatu 16:9 lub 4:3 i przyciąć wyświetlanie lub przetwarzanie podregionu.
  • Te proporcje są zorientowane na wykorzystanie maksymalnej powierzchni czujnika.
• Do interfejsów API konfiguracji przypadku użycia dodano parametr getTargetAspectRatio(), który zwraca współczynnik proporcji, na który jest przeznaczony wynik przypadku użycia.
• Metoda setTargetAspectRatio(Rational aspectRatio) została zmieniona w przypadku ImageCapture na setTargetAspectRatioCustom(Rational aspectRatio). Po ustawieniu tego ustawienia obraz wyjściowy jest przycinany odpowiednio.

Interfejsy API wykonawcy

• Poniższe funkcje akceptują parametr wykonawcy, który pozwala aplikacji kontrolować, na którym wykonawcy ma być wykonywana funkcja.
  • Preview.setOnPreviewOutputUpdateListener() API. Jeśli nie ma wykonawcy wykonania tej funkcji, jest ona wykonywana w wątku głównym.
  • Preview.setOnPreviewOutputUpdateListener
  • FocusMeteringAction.Builder.setAutoFocusCallback
  • ImageAnalysis.setAnalyzer
  • ImageCapture.takePicture
  • CameraView.takePicture
  • CameraView.startRecording
  • VideoCapture.startRecording

Dodano interfejs CameraInfo z interfejsami API do sprawdzania dostępności lampy błyskowej i obrotu czujnika

• Dodano metodę CameraInfo i getCameraInfo, która pozwala aplikacjom sprawdzić, czy obiektyw skierowany jest na CameraInfo i czy w danym aparacie jest dostępna lampa błyskowa. Na przykład:

  try {
      CameraInfo cameraInfo = CameraX.getCameraInfo(currentCameraLensFacing);
      LiveData<Boolean> isFlashAvailable = cameraInfo.isFlashAvailable();
      flashToggle.setVisibility(isFlashAvailable.getValue() ? View.VISIBLE : View.INVISIBLE);
  } catch (CameraInfoUnavailableException e) {
      Log.w(TAG, "Cannot get flash available information", e);
      flashToggle.setVisibility(View.VISIBLE);
  }
  

• Dodano użytkownika CameraInfo.getSensorRotationDegrees() Podaje orientację czujnika w odniesieniu do naturalnej orientacji urządzenia lub dla wygody – dla wygody – względem orientacji opisanej za pomocą obrotu powierzchni (który opisuje orientację względem naturalnej orientacji).

Zmiany w interfejsie API i poprawki błędów

• Formaty obrazu: w przypadku każdego zastosowania aplikacje powinny wywoływać tylko jedną z funkcji setTargetResolution() lub setTargetAspectRatio(). Wywołanie obu w tym samym module kompilującym spowoduje błąd.
  • Ogólnie zalecamy używanie setTargetAspectRatio() na podstawie projektu interfejsu aplikacji. Konkretne rozdzielczości zależą od przypadku użycia. Na przykład podgląd ma rozdzielczość zbliżoną do rozdzielczości ekranu, a nagrywanie obrazu zapewnia zdjęcia w wysokiej rozdzielczości. Więcej informacji znajdziesz w tabeli automatycznych rozdzielczości.
  • Zapisu setTargetResolution() używaj w bardziej konkretnych przypadkach, np. gdy wymagane są rozdzielczość minimalna (aby zapisać obliczenia) lub maksymalna (aby uzyskać więcej informacji o przetwarzaniu).
• Executor API: usunięto wywołanie setCallbackHandler() z interfejsów API konfiguracji przypadku użycia. Zamiast tego aplikacje mogą ustawić wykonawcę jako parametr w różnych innych interfejsach API, które ustawiają wywołanie zwrotne.
• Zaktualizowano adnotacje null dla różnych funkcji.
• Rozwiązaliśmy problem, który powodował błąd java.lang.IllegalStateException at Camera$StateCallback.onError podczas otwierania aparatu.
• Rozwiązanie problemu polegającego na tym, że gdy aplikacja żądała większej lub domyślnej rozdzielczości była za mała (mniej niż 640 x 480), obraz podglądu był rozmyty lub blokowy. Aplikacje, które potrzebują mniejszych rozdzielczości, mogą o nie poprosić.
• Rozwiązaliśmy problem, który powodował, że po powrocie z intencji, która uruchomiła inną aplikację do obsługi aparatu, kamera wyświetlała czarny ekran (nie udało się uruchomić aparatu).
• Naprawiliśmy błąd, który powodował wyświetlanie tego błędu przy wielokrotnym uruchamianiu lub zatrzymywaniu aplikacji. java.lang.IllegalArgumentException: CaptureRequest contains unconfigured Input/Output Surface!
• Usunięto błąd występujący podczas wyłączania funkcji ImageAnalysis: java.lang.IllegalStateException: maxImages (4) has already been acquired, call #close before acquiring more.
• Dodaliśmy dodatkowe testy procesu odłączania kamery.
• Zwiększona odporność systemu testowego podczas przeprowadzania testów aparatu w ciągu kilku minut.

Camera-Camera2 i Camera-Core w wersji 1.0.0-alpha05

5 września 2019 r.

androidx.camera:camera-camera2:1.0.0-alpha05 i androidx.camera:camera-core:1.0.0-alpha05 są dostępne. Oto kompilacje zawarte w camera-camera2:1.0.0-alpha05 i kompilacje zawarte w camera-core:1.0.0-alpha05.

• Zmiana w interfejsie API: zmieniono nazwy zmiennych błędów w przypadku użycia:

  • Nazwa ImageCapture.UseCaseError została zmieniona na ImageCapture.ImageCaptureError
  • Nazwa VideoCapture.UseCaseError została zmieniona na VideoCapture.VideoCaptureError

• Dodano interfejs CameraControl API z interfejsami API typu „Tap-to-fokus”

  • Dodano interfejs API umożliwiający pobieranie CameraControl z AparatuX dla aparatu wybranego przez obiektyw:

    CameraX.getCameraControl(LensFacing lensFacing)

  • Dodano aplikacje MeteringPointFactory, MeteringPoint, MeteringMode i FocusMeteringAction, które umożliwiają korzystanie z fokusu dotykiem:

    MeteringPointFactory factory = new SensorOrientedMeteringPointFactory(width, height);
    MeteringPoint point = factory.createPoint(x, y);
    FocusMeteringAction action = FocusMeteringAction.Builder.from(point,
                                     MeteringMode.AF_ONLY)
        .addPoint(point2, MeteringMode.AE_ONLY) // could have many
        .setAutoFocusCallback(new OnAutoFocusListener(){
            public void onFocusCompleted(boolean isSuccess) {
            }
        })
        // auto calling cancelFocusAndMetering in 5 sec.
        .setAutoCancelDuration(5, TimeUnit.Second)
        .build();
    

  • Dodano interfejs API CameraControl do uruchamiania i anulowania pomiaru ostrości:

    getCameraControl(lensFacing).startFocusAndMetering(action); getCameraControl(lensFacing).cancelFocusAndMetering();

  • Dodano interfejsy API dla punktów pomiarowych, które pomagają przekształcać współrzędne dotyku w współrzędne czujnika na podstawie klas widoku:

    MeteringPointFactory factory = new TextureViewMeteringPointFactory(textureView); MeteringPointFactory factory = new DisplayOrientedMeteringPointFactory(context, lensFacing, viewWidth, viewHeight);

• Wymuś wywołanie podanych niżej metod w wątku głównym (UI), a w przeciwnym razie rzutuj wyjątek IllegalStateException. W kolejnych wersjach będzie można używać innych wątków i zapewnić serializację.

  • CameraX.bindToLifecycle()
  • CameraX.unbind()
  • CameraX.unbindAll()
  • ImageAnalysis.setAnalyzer()
  • ImageAnalysis.getAnalyzer()
  • ImageAnalysis.removeAnalyzer()
  • Preview.removePreviewOutputListener()
  • Preview.getOnPreviewOutputUpdateListener()
  • Preview.setOnPreviewOutputUpdateListener()

• Różne ustawienia konfiguracji akceptują teraz parametry o wartości null, a odpowiednie metody pobierania mogą zwracać wartość null.

• Rozwiązano problem z testowaniem na emulatorach, które nie obsługują ustawień AF/AE/AWB.

• Naprawiono błąd awarii podczas obracania podczas analizowania obrazu.

• Rozwiązano błąd, który powodował, że po włączeniu (bez danych z kamery) podgląd był czarny, po przekręceniu lub przełączeniu między przednim a tylnym aparatem.

• Usunięto testowanie w przypadku wielu jednoczesnych zastosowań analizy obrazu. Aby zapewnić zgodność, aplikacje powinny zawierać tylko jeden przypadek użycia analizy obrazu.

• Dodano wstępne testy roboelektryczne fałszywych kamer w pakiecie do testowania aparatów (WIP).

• Test Camera2Inititalizer został usunięty, ponieważ jego zasięg był niejasny lub wprowadzał w błąd.

Camera-Camera2 i Camera-Core w wersji 1.0.0-alpha04

7 sierpnia 2019 r.

androidx.camera:camera-camera2:1.0.0-alpha04 i androidx.camera:camera-core:1.0.0-alpha04 są dostępne. Wersja 1.0.0-alpha04 zawiera te zatwierdzenia

Nowe funkcje

Zmiany w wybieraniu formatu obrazu i formatu obrazu w pełnej rozdzielczości

Celem CameraX jest inicjowanie sesji aparatu. Oznacza to, że CameraX musi iść na kompromisy w zakresie rozdzielczości i proporcji obrazu, aby umożliwić rozpoczęcie sesji rejestrowania, co jest jej głównym celem. Z tego powodu niektóre dokładne żądania mogą nie zostać spełnione. Możliwe przyczyny:

• Urządzenia, które nie obsługują żądanej rozdzielczości
• problemy ze zgodnością, np. na STARYCH urządzeniach, na których do prawidłowego działania wymagane są określone rozdzielczości;
• Na niektórych urządzeniach pewne formaty są dostępne tylko dla określonych formatów obrazu
• preferencję dotyczącą „najbliższego mod16” w przypadku kodowania JPEG lub wideo. Zobacz CameraCharacteristics#SCALER_STREAM_CONFIGURATION_MAP

Chociaż AparatX tworzy sesję i zarządza nią, zawsze sprawdzaj zwracane rozmiary obrazów w danych wyjściowych przypadku użycia w kodzie i w razie potrzeby wprowadzaj odpowiednie zmiany.

Wprowadziliśmy pewne zmiany w ustawieniach rozdzielczości i formatu obrazu, aby uprościć interfejs API:

• Przypadek użycia podglądu jest teraz uznawany za mający domyślny format obrazu 4:3, jeśli nie jest ustawiony żaden inny.
• Gdy CameraX wewnętrznie rozważa zmiany żądanych rozdzielczości i formatów obrazu na podstawie możliwości urządzenia, najpierw próbuje zachować ten sam format obrazu (określony przez dowolne wywołania setTargetAspectRatio lub setTargetResolution).
• Wersja „Nearest mod16” rozdzielczości jest uznawana za tę samą proporcję.

Tryb niezablokowany usługi ImageAnalysis

• Funkcja ImageReaderMode.ACQUIRE_LATEST_IMAGE nie blokuje już działania. Pobiera najnowszy obraz z kolejki, ale stale odrzuca nieużywane obrazy, aby potok kamery nie mógł go zablokować.
• Analizator może przechowywać pojedynczy obraz przez nieograniczony czas bez blokowania potoku.
• Jeśli aplikacja udostępnia wykonawcę, który następnie blokuje, blokuje to przypadki użycia ImageAnalysis.
• Domyślny zestaw wykonawcy działa wewnętrznie jako wykonawca nieblokujący.

Poprawki błędów

• Rozwiązanie problemów z czasem oczekiwania na konwergencję 3A podczas wykonywania zdjęć na urządzeniach bez automatycznego ustawiania ostrości, automatycznej ekspozycji i automatycznego balansu bieli.
• Rozwiązaliśmy problem występujący w przypadku szybkiego robienia zdjęć za pomocą funkcji ImageCapture. Naprawiono błąd: java.lang.IllegalStateException: maxImages (2) has already been acquired
• Rozwiązano problem, gdy funkcja setLensFacing nie była wywoływana w przypadku konkretnego przypadku użycia, co powodowało błąd java.lang.IllegalArgumentException: Unable to get camera ID for use case.
• Rozwiązano problem, w którym urządzenie starsze wymagało określonego formatu obrazu jako maksymalnej rozdzielczości JPEG.
• Rozwiązaliśmy problem z uruchamianiem aplikacji w tle podczas uruchamiania aparatu
• Usunięto problem z interfejsem API w wersji < 25 i usunięto błąd checkAndUpdateEglState: invalid current EGLDisplay.
• Rozwiązanie problemu z odwiązaniem podglądu po włączeniu i uruchomieniu rozszerzeń
• Artefakty kompilacji dla widoku aparatu i rozszerzeń aparatu są teraz publikowane jako wersje alfa.

Camera-Camera2 i Camera-Core w wersji 1.0.0-alpha03

2 lipca 2019 r.

androidx.camera:camera-core:1.0.0-alpha03 i androidx.camera:camera-camera2:1.0.0-alpha03 są dostępne. Wersja 1.0.0-alpha03 zawiera te zatwierdzenia

Zmiany w interfejsie API

• Dodano wyjaśnienie do pliku javadoc dotyczące elementu „target” w wywołaniach konfiguracji setTarget

Camera-Core

• Naprawiono awarię nieskonfigurowanej powierzchni wejściowej/wyjściowej przy szybkim otwarciu/zamykaniu lub powiązaniu/rozpoczęciu
• Przejście na nowe implementacje Futures
• Testowanie poprawek w celu bardziej rygorystycznego testowania
• Test integracji z serwerem Core pokazuje teraz czas wykonania zdjęć
• Stworzenie wewnętrznej klasy zgodności dla wykonawców
• Czas oczekiwania na zakończenie procesu rejestrowania zdjęć w aplikacji do testowania i poprawiona stabilność

Rozszerzenia

• Dodano weryfikację wersji.
• Dodatkowy zasięg testów – wywołania zwrotne zdarzeń rozszerzenia
• Ulepszenia dotyczące wewnętrznie odpowiadających sobie obrazów i metadanych
• Poprawki dotyczące przełączania trybów w aplikacji testowej

Camera-Camera2 i Camera-Core w wersji 1.0.0-alpha02

5 czerwca 2019 r.

androidx.camera:camera-core:1.0.0-alpha02 i androidx.camera:camera-camera2:1.0.0-alpha02 są dostępne. Wersja 1.0.0-alfa02 zawiera te zatwierdzenia.

Poprawki błędów

• Rozwiązaliśmy problem z dzieleniem przez 0 podczas korzystania z emulatora.
• Rozwiązano błąd NullPointerException/Surface Abandoned występujący na niektórych urządzeniach podczas szybkiego robienia zdjęć podczas szybkiego odwiązywania i ponownie wiązania przypadków użycia.
• Rozwiązano wewnętrzny problem, aby zapewnić spójność aktualizacji żądań rejestrowania na wszystkich platformach.
• Poprawki stabilności podczas ponownego uruchamiania przypadków użycia w nowych instancjach aplikacji
• Wewnętrzne zmiany architektury przygotowujące do obsługi wykonawców obsługujących interfejs API
• Dodatkowe wyjaśnienia dotyczące Javadoca dotyczącego klasy CameraX i zarządzania cyklem życia
• Dodano testowanie z wykorzystaniem testów instrumentowanych w przypadku aplikacji do testowania wydajności Antelope
• Usunięcie konieczności stosowania parametru „-keepattributes Signature” w konfiguracji Proguarda w aplikacji

Camera-Camera2 i Camera-Core 1.0.0-alpha01

7 maja 2019 r.

androidx.camera:camera-core:1.0.0-alpha01 i androidx.camera:camera-camera2:1.0.0-alpha01 zostały zwolnione. Wersja 1.0.0-alpha01 zawiera te zatwierdzenia:

Camera-Lifecycle w wersji 1.0.0-beta11

14 października 2020 r.

androidx.camera:camera-lifecycle:1.0.0-beta11 został zwolniony. Wersja 1.0.0-beta11 zawiera te commity.

Poprawki błędów

• <UseCase>.getTargetRotation() zwróci Surface.ROTATION_0, jeśli zostanie wywołana przed dołączeniem do instancji Camera, chyba że w Builderze lub UseCase ustawiono wartość targetRotation. (I80fcd)

Camera-Lifecycle w wersji 1.0.0-beta10

23 września 2020 r.

Usługa androidx.camera:camera-lifecycle:1.0.0-beta10 została zwolniona. Wersja 1.0.0-beta10 zawiera te commity.

Poprawki błędów

• Wersja na potrzeby obsługi rdzenia aparatu 1.0.0-beta10

Camera-Lifecycle Version 1.0.0-beta09

16 września 2020 roku

androidx.camera:camera-lifecycle:1.0.0-beta09 został zwolniony. Wersja 1.0.0-beta09 zawiera te commity.

Camera-Lifecycle Version 1.0.0-beta08

19 sierpnia 2020 r.

androidx.camera:camera-lifecycle:1.0.0-beta08 został zwolniony. Wersja 1.0.0-beta08 zawiera te commity.

Poprawki błędów

• Inicjowanie nie powinno już powodować awarii, gdy używasz kontekstu, który nie zwraca obiektu Application z Context.getApplicationContext(). (I3d3c9, b/160817073)

Camera-Lifecycle Version 1.0.0-beta07

22 lipca 2020 r.

androidx.camera:camera-lifecycle:1.0.0-beta07 został zwolniony. Wersja 1.0.0-beta07 zawiera te zatwierdzenia.

Cykl życia kamery w wersji 1.0.0-beta06

24 czerwca 2020 r.

Usługa androidx.camera:camera-lifecycle:1.0.0-beta06 została zwolniona. Wersja 1.0.0-beta06 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Teraz można skonfigurować CameraX za pomocą metody ProcessCameraProvider#configureInstance() przed wywołaniem metody ProcessCameraProvider#getInstance(). Umożliwia to dostosowanie konfiguracji CameraXConfig bez konieczności implementowania interfejsu CameraXConfig.Provider w klasie Application aplikacji. (Ia1a8d)

Camera-Lifecycle Version 1.0.0-beta05

10 czerwca 2020 r.

Usługa androidx.camera:camera-lifecycle:1.0.0-beta05 została zwolniona. Wersja 1.0.0-beta05 zawiera te commity.

Poprawki błędów

• Rozwiązanie problemu z zawieszaniem się aplikacji podczas inicjowania CameraX, gdy telefon jest w trybie Nie przeszkadzać. Jeśli InitializationException zawiera CameraUnavailableException, zostanie ono ustawione na ListenableFuture wyniku inicjalizacji zamiast powodować zamykanie aplikacji. (I9909a, b/149413835)

Cykl życia kamery w wersji 1.0.0-beta04

27 maja 2020 r.

androidx.camera:camera-lifecycle:1.0.0-beta04 został zwolniony. Wersja 1.0.0-beta04 zawiera te zatwierdzenia.

Camera-Lifecycle Version 1.0.0-beta03

15 kwietnia 2020 roku

androidx.camera:camera-lifecycle:1.0.0-beta03 został zwolniony. Wersja 1.0.0-beta03 zawiera te komitowane zmiany.

Poprawki błędów

• Naprawiliśmy regresję z wersji beta03, w której wywołanie funkcji bindToLifecycle() z zerową wartością UseCase powodowało zgłoszenie zgłoszenia. Uniemożliwiło to pobranie elementu Camera bez powiązania UseCase.
• Poprawki do wydania camera-core

Camera-Lifecycle Wersja 1.0.0-beta01

26 lutego 2020 r.

androidx.camera:camera-lifecycle:1.0.0-beta01 został zwolniony. Wersja 1.0.0-beta01 zawiera te commity.

Poprawki błędów

• W dokumentacji dodano informację, że podczas uzyskiwania wartości ProcessCameraProvider podczas inicjalizacji używana jest konfiguracja domyślna, a rozszerzanie wartości Application jest opcjonalne. (I5e395)

Camera-Lifecycle w wersji 1.0.0-beta02

1 kwietnia 2020 r.

Usługa androidx.camera:camera-lifecycle:1.0.0-beta02 została zwolniona. Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Poprawki błędów

• Zaktualizowano, aby obsługiwać poprawki błędów w artefaktach camera-camera2:1.0.0-beta02 i camera-core:1.0.0-beta02.

Camera-Lifecycle Wersja 1.0.0-alpha10

10 lutego 2020 r.

Usługa androidx.camera:camera-lifecycle:1.0.0-alpha10 została zwolniona. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia:

Zmiany w interfejsie API

• Dodano adnotację @MainThread do metod BindToLifecycle, unbind i unbindAll. (I990d2)

Camera-Lifecycle Version 1.0.0-alpha03

22 stycznia 2020 r.

androidx.camera:camera-lifecycle:1.0.0-alpha03 został zwolniony. Wersja 1.0.0-alpha03 zawiera te zatwierdzenia

Aktualizacje

• Wprowadzono różne poprawki i aktualizacje umożliwiające obsługę zmian w Camera Core i Camera2.

Camera-Lifecycle Version 1.0.0-alpha02

18 grudnia 2019 r.

Usługa androidx.camera:camera-lifecycle:1.0.0-alpha02 została zwolniona. Wersja 1.0.0-alfa02 zawiera te zatwierdzenia.

Zmiany zależności

• Zmieniono na androidx.camera:camera-core:1.0.0-alpha08.

Camera-Lifecycle Version 1.0.0-alpha01

4 grudnia 2019

androidx.camera:camera-lifecycle:1.0.0-alpha01 został zwolniony. Wersja 1.0.0-alpha01 pakietu camera-lifecycle zawiera te commity

Uwagi dotyczące interfejsu API

• Dodano artefakt cyklu życia aparatu, który udostępnia interfejs LifeCycleCameraProvider oraz implementację o nazwie ProcessCameraProvider, która zapewnia wiele funkcji poprzedniej klasy CameraX w jądrze i jest uzyskiwana za pomocą metody getInstance().
• Aplikacje powinny zawierać bibliotekę cyklu życia aparatu, aby korzystać z CameraX.
• Aby dowiedzieć się, jak zainicjować CameraX za pomocą ProcessCameraProvider, zapoznaj się z notatkami w sekcji camera-core.

Rozszerzenia aparatu i widok aparatu w wersji 1.0.0

Wersja 1.0.0-alfa32

15 grudnia 2021 roku

androidx.camera:camera-extensions:1.0.0-alpha32 i androidx.camera:camera-view:1.0.0-alpha32 są dostępne. Wersja 1.0.0-alpha32 zawiera te commity.

Zmiany w interfejsie API

• Usunięto zbędne adnotacje @RequiresApi(21) z klas i interfejsów wewnętrznych. (I8e286, b/204917951)
• Zaktualizuj pliki interfejsu API dla artefaktu rozszerzeń aparatu. (If683a, b/161377155)

Poprawki błędów

• Zablokuj możliwość włączania trybów rozszerzenia podczas wiązania VideoCapture. Rozszerzenia CameraX obsługują tylko ImageCapture i Preview. VideoCapture nie jest jeszcze obsługiwany. Jeśli aplikacja wiąże VideoCapture i włączy dowolny tryb rozszerzenia, zostanie wywołana funkcja IllegalArgumentException. (I0d87b)
• Funkcja CameraSelector#filter nie zwraca już błędu IllegalArgumentException, gdy zbiór wyników jest pusty. (I27804)
• Nazwa interfejsu API ExtensionsManager#getInstance została zmieniona na getInstanceAsync, ponieważ zwraca on odpowiedź ListenableFuture. Sufiks „Async” w nazwie funkcji może wyraźnie wskazywać, że jest to funkcja asynchroniczna. (I279d2)
• Usuń parametr rozdzielczości z interfejsu API ExtensionsManager#getEstimatedCaptureLatencyRange, ponieważ użytkownicy nie wiedzą, które rozmiary są obsługiwane w przypadku użycia ImageCapture, i nie mogą odróżnić, czy zwrócone informacje o opóźnieniu dotyczą maksymalnego rozmiaru wyjściowego nagrania czy parametru rozdzielczości wejściowej. (I74bb2)
• Przeniesienie parametru CameraProvider funkcji ExtensionsManager do interfejsu getInstance() API. Użytkownicy nie muszą wpisywać parametru CameraProvider za każdym razem, gdy wywołują funkcje ExtensionsManager. (IC7e48)

Wersja 1.0.0-alfa31

17 listopada 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha31 i androidx.camera:camera-view:1.0.0-alpha31 zostały udostępnione. Wersja 1.0.0-alpha31 zawiera te commity.

Zmiany w interfejsie API

• Do publicznego interfejsu API dodano CameraSelector#filter, aby filtrować listę obiektów CameraInfos na podstawie selektora CameraSelector. (I105d0)

Poprawki błędów

• Naprawienie problemu z awariami podczas szybkiego przełączania trybu rozszerzeń na niektórych urządzeniach. (Iebbef)

Wersja 1.0.0-alpha30

13 października 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha30 i androidx.camera:camera-view:1.0.0-alpha30 zostały udostępnione. Wersja 1.0.0-alfa30 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Do wszystkich klas CameraX dodano adnotację @RequiresApi(21) oraz usunięto minSdkVersion z pliku AndroidManifest.xml. Dzięki temu biblioteka camera-core będzie można łatwo zintegrować z aplikacjami, w których parametr minSdkVersion ma wartość mniejszą niż 21, ale które mają warunkowo używać ścieżek kodu korzystających z interfejsu API 21 lub nowszego. Ta zmiana nie wymaga żadnych działań w przypadku aplikacji z parametrem minSdkVersion 21 lub nowszym. (Ie7f2e, b/200599470)

Poprawki błędów

• Rozwiązaliśmy problem z błędem AbstractMethodError, który pojawia się po włączeniu Proguarda. (Iae468, b/201177844)

Wersja 1.0.0-alfa29

29 września 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha29 i androidx.camera:camera-view:1.0.0-alpha29 zostały udostępnione. Wersja 1.0.0-alfa29 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Oznaczenie ExperimentalUseCaseGroup zostało usunięte, ponieważ interfejsy API nie są już eksperymentalne. (I01ef5).
• usuń RotationProvider#removeAllListeners(). Zamiast tego użyj elementu RotationProvider#removeListener(...). (Id9d4a)
• Zaktualizowano klasę RotationReceiver: zmieniono metodę set/clear Listener na add/remove/removeAll, usunięto wariant setListener, który domyślnie używa głównego wątku, oraz dodano adnotację metod. (Ib1669)

Poprawki błędów

• Zmieniliśmy nazwę ExtensionMode#BEAUTY na FACE_RETOUCH, aby poprawnie przedstawiać, co robi tryb rozszerzenia. (I61f54, b/198515274)
• Rozwiązaliśmy problem polegający na tym, że kamera jest nieoczekiwanie zamykana, gdy w ramach jednej czynności używane są liczne elementy CameraController i PreviewView. (Ibfd18, b/197539358)

Wersja 1.0.0-alpha28

18 sierpnia 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha28 i androidx.camera:camera-view:1.0.0-alpha28 zostały udostępnione. Wersja 1.0.0-alpha28 zawiera te commity.

Zmiany w interfejsie API

• Adnotacja ExperimentalUseCaseGroupLifecycle została usunięta, ponieważ interfejsy API nie są już eksperymentalne. (I17b85)
• przekształciliśmy klasę RotationListener i zmieniliśmy jej nazwę na RotationProvider. Nadal zapewnia te same funkcje, ale z nieco innym interfejsem API. (Idffc5)
• Zmień nazwę TAP_TO_FOCUS_UNSUCCESSFUL na TAP_TO_FOCUS_NOT_FOCUSED i TAP_TO_FOCUS_SUCCESSFUL na TAP_TO_FOCUS_FOCUSED. Wynik ostatecznego rozmiaru wyjściowego (I099fa)

Poprawki błędów

• Usunięto przestarzałe klasy <EffectName><UseCase>Extender, ExtensionsErrorListener i powiązane interfejsy API ExtensionsManager. (I3b8c3)

Wersja 1.0.0-alpha27

21 lipca 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha27 i androidx.camera:camera-view:1.0.0-alpha27 są dostępne. Wersja 1.0.0-alfa27 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Interfejs Viewport API przestał być eksperymentalny. Usuń eksperymentalną adnotację interfejsu API. (I717ea)
• Zmieniono nazwę CoordinateTransform#getTransform na CoordinateTransform#transform i zaktualizowano JavaDoc (I864ae)

Poprawki błędów

• Rozwiązaliśmy problem z rozciąganiem się trybu PreviewView PERFORMANCE, gdy był używany razem z interfejsem tworzenia wiadomości. (Ie1137, b/183864890)

Wersja 1.0.0-alpha26

30 czerwca 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha26 i androidx.camera:camera-view:1.0.0-alpha26 są dostępne. Wersja 1.0.0-alpha26 zawiera te commity.

Zmiany w interfejsie API

• dodaj nową metodę CameraController#getTapToFocusState(), która ukazuje najnowszy wynik dotknięcia ekranu. (Iaccb0)
• dodanie do klasy CameraController dodatkowych funkcji związanych z jądrem aparatu: metod gettera/settera docelowego formatu obrazu, docelowej rozdzielczości, trybu przechwytywania, metody CameraControl i niestandardowych wykonawców; (Iea8f2)
• dodaj klasę RotationReceiver, która odbiera zmiany orientacji Surface. Można go użyć do ustawienia docelowego obrotu, gdy urządzenie jest w trybie pionowym lub poziomym. (IB278f)
• Udostępniono nowe publiczne interfejsy API getEstimateCaptureLatencyRange w klasie ExtensionsManager. (I6a8ec)
• Wycofana klasa ExtensionsErrorListener. Obecnie ten interfejs służy wyłącznie do sprawdzania, czy po włączeniu trybów rozszerzeń nie ma funkcji Podgląd lub Przechwytywanie obrazów. CameraX automatycznie doda dodatkowy podgląd lub ImageCapture, aby funkcje rozszerzenia działały prawidłowo. Po tym czasie nie będzie już żadnych błędów w tym interfejsie. (I47d9e)
• Udostępniono nowe interfejsy API publiczne ExtensionsManager getInstance, isExtensionAvailable i getExtensionEnabledCameraSelector oraz wycofano stare klasy <EffectName><UseCase>Extender i powiązane z nimi interfejsy API. (I329e6)

Wersja 1.0.0-alfa25

2 czerwca 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha25 i androidx.camera:camera-view:1.0.0-alpha25 są dostępne. Wersja 1.0.0-alpha25 zawiera te commity.

Zmiany w interfejsie API

• Interfejsy ExperimentalCameraFilter API nie są już w fazie eksperymentalnej i zostały oficjalnie udostępnione. Można ich używać bez adnotacji. (I4Bc94)
• Dodaj narzędzie, które przekształca współrzędne między zastosowaniami. Przykład użycia: przekształcenie współrzędnych wykrytych w przypadku analizy obrazu i wyróżnienie wykrytego obiektu na podglądzie. (I63ab1, b/137515129)
• Użytkownik CameraView został usunięty. Pole CameraView zostało zastąpione elementem CameraController. Więcej informacji o migracji znajdziesz w przewodniku po migracji: (Id5005)

Poprawki błędów

• Tekst ExperimentalUseCaseGroupLifecycle zastąpiono elementem ExperimentalUseCaseGroup. (I3b2ef, b/159033688)

Wersja 1.0.0-alpha24

21 kwietnia 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha24 i androidx.camera:camera-view:1.0.0-alpha24 są dostępne. Wersja 1.0.0-alfa24 zawiera te zatwierdzenia.

Poprawki błędów

• W przypadku interfejsów API w wersji eksperymentalnej zastąpiono adnotację @Experimental adnotacją @RequiresOptIn. Do wywoływania eksperymentalnych interfejsów API używaj interfejsu androidx.annotation.OptIn zamiast wycofanego androidx.annotation.experimental.UseExperimental. (Iff226)
• Usunięto problem z rozciągniętym podglądem na Samsungu J5 Prime (Ib10b6).

Rozszerzenia i widok aparatu w wersji 1.0.0-alpha23

24 marca 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha23 i androidx.camera:camera-view:1.0.0-alpha23 są dostępne. Wersja 1.0.0-alpha23 zawiera te commity.

Zmiany w interfejsie API

• Komponent CameraView jest wycofywany. Zamiast niej używaj elementu LifecycleCameraController. Zapoznaj się z przewodnikiem po migracji (Idac2c).
• Dodano adnotację FloatRange do setLinearZoom() (I69971)

Poprawki błędów

• Zablokowane zależności widoku kamery, aby korzystały z elementów wersji 1.0.0. W zależności od wersji camera-view nie będzie już powodować, że Gradle automatycznie aktualizuje zależności camera-core, camera-camera2 i camera-lifecycle do najnowszych artefaktów w wersji 1.1.0, ale camera-view nadal będzie kompatybilna z tymi artefaktami, jeśli zostaną one wyraźnie skonfigurowane do użycia wersji 1.1.0. (Ic8fa1, b/181599852)
• Rozwiązano problem z rozciągniętym podglądem Samsunga A3 w PreviewView. (Iacb30, b/180121821)
• Rozwiązaliśmy problem polegający na tym, że selektor kamery nie może zostać ustawiony przed zainicjowaniem kamery. (IC8bd0)

Rozszerzenia i widok aparatu w wersji 1.0.0-alpha22

24 lutego 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha22 i androidx.camera:camera-view:1.0.0-alpha22 są dostępne. Wersja 1.0.0-alfa22 zawiera te zatwierdzenia.

Zmiany w interfejsie API

• Dodanie metody getter CameraInfo do elementu CameraController. (Ib8138, b/178251727)

Poprawki błędów

• Naprawiono ExtensionsErrorListener, aby zgłaszać błędy, gdy tylko podgląd lub ImageCapture są powiązane. (I5ae39)

Rozszerzenia i widok aparatu w wersji 1.0.0-alpha21

27 stycznia 2021 r.

androidx.camera:camera-extensions:1.0.0-alpha21 i androidx.camera:camera-view:1.0.0-alpha21 są dostępne. Wersja 1.0.0-alpha21 zawiera te commity.

Publikowanie w celu obsługi innych artefaktów biblioteki aparatu.

Rozszerzenia i widok aparatu w wersji 1.0.0-alpha20

16 grudnia 2020 roku

androidx.camera:camera-extensions:1.0.0-alpha20 i androidx.camera:camera-view:1.0.0-alpha20 są dostępne. Wersja 1.0.0-alpha20 zawiera te commity.

Opublikowanie w celu obsługi innych artefaktów biblioteki aparatu.

Camera-Extensions & Camera-View w wersji 1.0.0-alpha19

11 listopada 2020 roku

androidx.camera:camera-extensions:1.0.0-alpha19 i androidx.camera:camera-view:1.0.0-alpha19 są dostępne. Wersja 1.0.0-alfa19 zawiera te zatwierdzenia.

Poprawki błędów

• W widoku kamery wprowadzono adnotację @ExperimentalVideo. Ta adnotacja oznacza interfejsy API udostępniające eksperymentalne funkcje wideo, które mogą się zmienić w miarę opracowania nowych funkcji. Każda metoda korzystająca z tych interfejsów API powinna używać adnotacji @UseExperimental z wartością ExperimentalVideo jako markerClass. (I6d729)

Camera-Extensions w wersji 1.0.0-alpha18

14 października 2020 r.

Usługa androidx.camera:camera-extensions:1.0.0-alpha18 została zwolniona. Wersja 1.0.0-alpha18 zawiera te commity.

Poprawki błędów

• Krótszy czas oczekiwania na inicjalizację i tworzenie powiązań kameryX (I61dc5)
• <UseCase>.getTargetRotation() zwróci Surface.ROTATION_0, jeśli zostanie wywołana przed dołączeniem do instancji Camera, chyba że w Builderze lub UseCase ustawiono wartość targetRotation. (I80fcd)

Widok z aparatu w wersji 1.0.0-alfa18

14 października 2020 r.

Usługa androidx.camera:camera-view:1.0.0-alpha18 została zwolniona. Wersja 1.0.0-alpha18 zawiera te commity.

Opublikowanie w celu obsługi innych artefaktów biblioteki aparatu.

Camera-Extensions w wersji 1.0.0-alpha17

23 września 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha17 został zwolniony. Wersja 1.0.0-alpha17 zawiera te commity.

Poprawki błędów

• Wersja na potrzeby obsługi rdzenia aparatu 1.0.0-beta10

Widok z aparatu w wersji 1.0.0-alfa17

23 września 2020 r.

androidx.camera:camera-view:1.0.0-alpha17 został zwolniony. Wersja 1.0.0-alpha17 zawiera te commity.

Poprawki błędów

• Wersja obsługująca Camera-Core 1.0.0-beta10

Rozszerzenia aparatu w wersji 1.0.0-alfa16

16 września 2020 roku

androidx.camera:camera-extensions:1.0.0-alpha16 został zwolniony. Wersja 1.0.0-alpha16 zawiera te commity.

Poprawki błędów

• Dodano metodę w ExtensionsManager, aby uzyskać obiekt Extensions, który służy do włączania i wyszukiwania rozszerzeń w przypadku instancji aparatu (I4fb7).

Widok z aparatu, wersja 1.0.0-alpha16

16 września 2020 roku

androidx.camera:camera-view:1.0.0-alpha16 został zwolniony. Wersja 1.0.0-alpha16 zawiera te commity.

Zmiany w interfejsie API

• Usunięto PreviewView#setDeviceRotationForRemoteDisplayMode() i PreviewView#getDeviceRotationForRemoteDisplayMode(). Dwie metody umożliwiają dostosowanie obrotu podglądu, gdy pożądana obrót nie jest równoznaczna z obrotem wyświetlacza, np. wyświetlaczem zdalnym. Aby teraz obsłużyć rotację podglądu niewyświetlanego, ustaw żądaną rotację za pomocą Preview#setTargetRotation() i nowego PreviewView#getViewPort(targetRotation). (Ib62cc)
• Nazwa createSurfaceProvider() została zmieniona na getSurfaceProvider(). Metoda zawsze zwraca ten sam element Preview.SurfaceProvider. (Iff83c).

Poprawki błędów

• Wymuszone jest użycie w podglądzie właściwości TextureView, jeśli włączony jest efekt rozszerzenia, a implementacja biblioteki dostawcy musi wykonać specjalny proces na powierzchni wyjściowej. (I0c3cc)
• Zezwalanie na dowolny obrót obiektu w podglądzie. Informacje o przekształceniu są obliczane i zwracane użytkownikowi w locie za pomocą nowego wywołania zwrotnego TranformationInfoListener. (I21470)

Znane problemy

• W metodzie PreviewView funkcja OnClickListener#onClick() nie jest wywoływana, gdy użytkownik kliknie PreviewView. PodglądView#onTouchEvent() jest błędnie przetwarzany jako zdarzenie dotknięcia. Ten problem zostanie rozwiązany w następnej wersji.
• Wartość MeteringPoint uzyskana z PreviewView#getMeteringPointFactory() może być nieprawidłowa, jeśli z funkcją PreviewView używany jest interfejs ViewPort.

Camera-Extensions w wersji 1.0.0-alpha15

19 sierpnia 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha15 został zwolniony. Wersja 1.0.0-alfa15 zawiera te zatwierdzenia.

Poprawki błędów

• Metoda ExtensionsManager.init() przyjmuje teraz kontekst jako parametr, a nie 0 argumentów. (Ife754).

• Inicjowanie nie powinno już powodować awarii, gdy używasz kontekstu, który nie zwraca obiektu Application z Context.getApplicationContext(). (I3d3c9, b/160817073)

  Widok z aparatu, wersja 1.0.0-alpha15

  19 sierpnia 2020 r.

Usługa androidx.camera:camera-view:1.0.0-alpha15 została zwolniona. Wersja 1.0.0-alpha15 zawiera te commity.

Poprawki błędów

• Funkcja DisplayOrientedMeteringPointFactory przyjmuje instancję CameraInfo zamiast CameraSelector, więc istnieje bezpośrednie mapowanie na potrzeby tworzenia punktów dla aparatu, którego będzie używać fabryka. Wszystkie klasy, które używają DisplayOrientedMeteringPointFactory, przyjmują też instancję CameraInfo zamiast CameraSelector. (I400c1)
• Użytkownik TextureViewMeteringPointFactory został usunięty. Usługa PreviewView udostępnia publiczny interfejs API (createMeteringPointFactory()) do tworzenia fabryki punktów pomiarowych niezależnie od tego, czy korzysta ona z interfejsu TextureView czy SurfaceView. (Ide693)
• zmień nazwę trybów implementacji podglądu SURFACE_VIEW/TEXTURE_VIEW na PERFORMANCE/COMPATIBLE. PERFORMANCE to stary tryb SURFACE_VIEW, a COMPATIBLE to stary tryb TEXTURE_VIEW. (I0edc2)
• W przypadku przechwytywania obrazu zastąpij flagę przechyłu poziomego w metadanych na podstawie kierunku kamery. (I28499)

Camera-Extensions w wersji 1.0.0-alpha14

22 lipca 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha14 został zwolniony. Wersja 1.0.0-alfa14 zawiera te zatwierdzenia.

Widok z aparatu w wersji 1.0.0-alfa14

22 lipca 2020 r.

Usługa androidx.camera:camera-view:1.0.0-alpha14 została zwolniona. Wersja 1.0.0-alpha14 zawiera te zatwierdzenia.

Camera-Extensions w wersji 1.0.0-alpha13

24 czerwca 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha13 został zwolniony. Wersja 1.0.0-alpha13 zawiera te zatwierdzenia.

Poprawki błędów

• Dodano eksperymentalne interfejsy do filtrowania kamer według identyfikatora kamery i właściwości CameraCharacteristics. (I28f61)

Widok z aparatu, wersja 1.0.0-alpha13

24 czerwca 2020 r.

androidx.camera:camera-view:1.0.0-alpha13 został zwolniony. Wersja 1.0.0-alfa13 zawiera te zatwierdzenia.

Poprawki błędów

• CameraView nie ulega już awarii z błędem IllegalArgumentException podczas wiązania z LifecycleOwner, którego stan Lifecycle przechodzi w stan DESTROYED wkrótce po wiązaniu. Binding Lifecycles w stanie DESTROYED nie próbuje otworzyć kamery. (I7c2b8)
• Stan strumienia PreviewView jest teraz dostępny za pomocą CameraView.getPreviewStreamState() (I21a2b).

Camera-Extensions w wersji 1.0.0-alpha12

10 czerwca 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha12 został zwolniony. Wersja 1.0.0-alpha12 zawiera te commity.

Poprawki błędów

• Rozwiązanie problemu z zawieszaniem się aplikacji podczas inicjowania CameraX, gdy telefon jest w trybie Nie przeszkadzać. Pole InitializationException zawiera pole CameraUnavailableException, które zostanie ustawione na wartość ListenableFuture wyniku inicjalizacji, zamiast powodować awarie aplikacji. (I9909a, b/149413835)

Widok z aparatu, wersja 1.0.0-alpha12

10 czerwca 2020 r.

androidx.camera:camera-view:1.0.0-alpha12 został zwolniony. Wersja 1.0.0-alpha12 zawiera te commity.

Poprawki błędów

• Dodaj interfejs API PreviewView#getBitmap(), który zwraca reprezentację bitmapy treści wyświetlanej na platformie podglądu. (I9b500, b/157659818)

Rozszerzenia aparatu w wersji 1.0.0-alfa11

27 maja 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha11 został zwolniony. Wersja 1.0.0-alpha11 zawiera te commity.

Widok z aparatu w wersji 1.0.0-alfa12

10 czerwca 2020 r.

androidx.camera:camera-view:1.0.0-alpha12 został zwolniony. Wersja 1.0.0-alfa12 zawiera te zatwierdzenia.

Nowe funkcje

Zmiany w interfejsie API

Poprawki błędów

• Dodaj PreviewView#getBitmap() API, które zwraca reprezentację bitmapową treści wyświetlanych na powierzchni podglądu. (I9b500, b/157659818)

Camera-View Wersja 1.0.0-alpha11

27 maja 2020 r.

androidx.camera:camera-view:1.0.0-alpha11 został zwolniony. Wersja 1.0.0-alfa11 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Dodaj interfejs API PreviewView#getPreviewStreamState, który umożliwi aplikacjom sprawdzanie, czy podgląd jest przesyłany strumieniowo. Gdy widok podglądu jest w trybie TEXTURE_VIEW, stan STREAMING również gwarantuje, że obraz podglądu jest widoczny. (IC0906, b/154652477)
• Dodano interfejs API PreviewView#setDeviceRotationForRemoteDisplayMode(), aby umożliwić obracanie urządzenia w celu obliczenia przekształcenia, jeśli aplikacja działa w trybie wyświetlania zdalnego. (I59b95, b/153514525)

Poprawki błędów

• Rozwiązaliśmy problem z zniekształceniem podglądu na kamerach FULL/LIMITED/LEVEL_3 z Androidem 7.0 lub starszym. Tryb wymuszonego korzystania ImplementationMode#TEXTURE_VIEW, gdy wersja Androida jest 7.0 lub starsza. (I83e30, b/155085307)
• Parametr CameraInfo został usunięty z funkcji PreviewView#createSurfaceProvider(), a funkcja PreviewView pobiera go teraz wewnętrznie z funkcji SurfaceRequest. (If18f0, b/154652477)
• Naprawiono domyślny współczynnik proporcji przechwytywania obrazu w kamerze 16:9. (Ie6a7b, b/153237864)
• Napraw problemy z czarnym ekranem (PreviewView) po przesunięciu fragmentu Preview po przesunięciu z powrotem w ViewPager2. Rozwiązano też problem, gdy removeView(previewview), a potem addView(previewView). (IAb555, b/149877652, b/147354615)
• Zaktualizuj interfejs API CameraView#takePicture(), aby umożliwić zapisywanie obrazów w usługach Uri i OutputStream. Zaktualizuj aplikację testową, aby używała Uri jako przykładu kanonicznego. (Ia2459, b/153607583)
• Typ skali PreviewView możesz ustawić w układzie XML, określając atrybut ScaleType. (I08565, b/153015659)
• CameraView.ScaleType został(a) usunięty(a). Zamiast tego użyj funkcji PreviewView.ScaleType, aby ustawić lub pobrać typ skali w CameraView. (Ia8974, b/153014831)
• Domyślnie nadaj PreviewView kolor tła, jeśli nie ma go jeszcze domyślnie. Zapobiega to wyświetlaniu treści znajdujących się za nim przed rozpoczęciem strumienia podglądu. (I09fad)

Camera-Extensions Wersja 1.0.0-alpha10

15 kwietnia 2020 roku

androidx.camera:camera-extensions:1.0.0-alpha10 został zwolniony. Wersja 1.0.0-alpha10 zawiera te zatwierdzenia.

Poprawki błędów

• poprawki umożliwiające wydanie Camera-Core;

Widok z kamery – wersja 1.0.0-alpha10

15 kwietnia 2020 roku

androidx.camera:camera-view:1.0.0-alpha010 został zwolniony. Wersja 1.0.0-alpha010 zawiera te commity.

Poprawki błędów

• Rozwiązano wcześniej znany problem, który powodował, że implementacja PreviewView w surfaceView nie działała prawidłowo na niektórych urządzeniach i powodowała awarię aplikacji po wznowieniu podglądu. (I5ed6b)

Rozszerzenia aparatu w wersji 1.0.0-alfa09

Kwiecień 1, 2020

androidx.camera:camera-extensions:1.0.0-alpha09 został zwolniony. Wersja 1.0.0-alfa09 zawiera te zatwierdzenia.

Poprawki błędów

• Zaktualizowano je, aby obsługiwały poprawki błędów w artefaktach camera-camera2:1.0.0-beta02, camera-core:1.0.0-beta02 i camera-lifecycle:1.0.0-beta02

Widok z aparatu, wersja 1.0.0-alpha09

1 kwietnia 2020 r. androidx.camera:camera-view:1.0.0-alpha09 została opublikowana. Wersja 1.0.0-alfa09 zawiera te zatwierdzenia.

Znane problemy

• Korzystanie z funkcji ImplementationMode.SURFACE_VIEW w komponencie PreviewView może nie działać prawidłowo na niektórych urządzeniach. Dzieje się tak, ponieważ komponent SurfaceView używany do podglądu staje się nieważny, gdy cykl życia okna, w którym się znajduje, zostanie zatrzymany. Gdy zostanie ponownie uruchomiony, kamera zostanie ponownie otwarta i może spróbować wznowić podgląd, zanim powierzchnia SurfaceView stanie się ponownie ważna. Na razie należy używać ImplementationMode.TEXTURE_VIEW.

Zmiany w interfejsie API

• Nazwa PreviewView.setImplementationMode() została zmieniona na PreviewView.setPreferredImplementationMode().
• Nazwa PreviewView.getImplementationMode() została zmieniona na PreviewView.getPreferredImplementationMode().
• Zastąpiono PreviewView.getSurfaceProvider() przez PreviewView.createSurfaceProvider(CameraInfo). W tym celu przy użyciu instancji CameraInfo z wartością null stosowaną w celu optymalizacji podglądu przy użyciu w miarę możliwości ImplementationMode.SURFACE_VIEW. Jeśli przekazano instancję null lub preferowany tryb implementacji ma wartość ImplementationMode.TEXTURE_VIEW, wewnętrznie używana jest wartość ImplementationMode.TEXTURE_VIEW.

• Ten przykładowy kod pokazuje, jak wcześniej używano podglądu za pomocą metody PreviewView.

  preview.setSurfaceProvider(previewView.previewSurfaceProvider)
  cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)
  

  Obecnie możesz napisać:

  val camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)
  previewView.preferredImplementationMode = ImplementationMode.TEXTURE_VIEW
  preview.setSurfaceProvider(previewView.createSurfaceProvider(camera.cameraInfo))
  

• Do PreviewView.getSurfaceProvider() została dodana adnotacja @UiThread, co oznacza, że należy ją wywołać z wątku głównego. (I192f3)

• Dodano element PreviewView.setScaleType(), który umożliwia ustawienie typu skali podglądu. Może przyjmować jedną z wartości w sekcji PreviewView.ScaleType, a domyślnie przyjmuje wartość PreviewView.ScaleType.FILL_CENTER.

• Dodano PreviewView.getScaleType().

• Usunięto obsługę ustawiania trybu implementacji dla PreviewView w układzie XML za pomocą atrybutu implementationMode.

• Dodaj interfejs createMeteringPointFactory() API do PreviewView, aby umożliwić konwersję (x, y) w PreviewView na MeteringPoint. (Ib36d7)

Poprawki błędów

• Naprawiono sytuacje, w których po zmianie rozmiaru elementu PreviewView wyświetlany jest nieprawidłowy podgląd. (I71101)

Camera-Extensions w wersji 1.0.0-alpha08

26 lutego 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha08 został zwolniony. Wersja 1.0.0-alpha08 zawiera te commity.

Widok z aparatu, wersja 1.0.0-alpha08

26 lutego 2020 r.

Usługa androidx.camera:camera-view:1.0.0-alpha08 została zwolniona. Wersja 1.0.0-alfa08 zawiera te zatwierdzenia.

Poprawki błędów

• Zawartość komórki ListenableFuture w kolumnie SurfaceRequest.provideSurface() została zastąpiona przez Executor i Callback. Upraszcza to interfejs API, ponieważ nie wymaga już obsługi wyjątków w przypadku provideSurface() i zapewnia, że wywołania zwrotnego provideSurface() nie można anulować. Ma to zapobiegać awariom na starszych urządzeniach spowodowanym przez przedwczesne zwalnianie powierzchni. Obiekt SurfaceRequest.Result jest teraz używany do śledzenia sposobu korzystania przez SurfaceRequest z podawanego obiektu Surface. (I7854b)
• Zmieniono nazwę SurfaceRequest.setSurface(Surface) na SurfaceRequest.provideSurface(Surface), a SurfaceRequest.setWillNotComplete() na SurfaceRequest.willNotProvideSurface(). (I224fe)
• Naprawiono inicjowanie wariantów aplikacji z włączoną funkcją ProGuard przez zachowanie flagi ustawiającej domyślnego dostawcę CameraXConfig. (I2d6c1)

Camera-Extensions w wersji 1.0.0-alpha07

10 lutego 2020 r.

androidx.camera:camera-extensions:1.0.0-alpha07 został zwolniony. Wersja 1.0.0-alfa07 zawiera te zatwierdzenia.

Poprawki błędów

• Argumenty, które były wcześniej przekazywane w parametrach ImageCapture.OnImageSavedCallback.onError() i ImageCapture.OnImageCapturedCallback.onError(), zostały zastąpione przez pojedynczy argument ImageCaptureException, który nadal zawiera wszystkie informacje, które były przekazywane wcześniej.
• Argument pliku przekazany wcześniej w funkcji ImageCapture.OnImageSavedCallback.onImageSaved() został usunięty. (I750d2)

Widok z aparatu – wersja 1.0.0-alpha07

10 lutego 2020 r.

androidx.camera:camera-view:1.0.0-alpha07 został zwolniony. Wersja 1.0.0-alfa07 zawiera te zatwierdzenia.

Zmiany interfejsu API

• Implementacja PreviewView TextureView ustawia teraz rozmiar TextureView na rozmiar wyjściowy czujnika aparatu, zanim zostanie ona przeskalowana, aby wypełnić element nadrzędny PreviewView. Jeśli chcesz, aby podgląd kamery wypełniał całą część interfejsu użytkownika (np. cały ekran), nie należy ustawiać rozmiaru PreviewView na stałą wartość ani nie należy stosować zawinięcia zawartości (np. za pomocą atrybutu „wrap_content”). Może to spowodować, że podgląd kamery wypełni tylko część PreviewView (jeśli rozmiar wyjściowy czujnika kamery jest mniejszy). Zamiast tego należy ustawić PreviewView tak samo duży jak jego nadrzędny (np. za pomocą atrybutu „match_parent”). (1204869)

Poprawki błędów

• Zaktualizowano ImageCapture, aby umożliwić zapisywanie obrazów w folderach Uri i OutputStream. Połączone przeciążone metody takePicture w jedną. Zaktualizowaliśmy aplikację testową, aby używała przykładu wersji kanonicznej Uri. (Ia3bec)
• Nazwa Preview.PreviewSurfaceProvider została zmieniona na Preview.SurfaceProvider. SurfaceProvider nie wymagają już od programistów tworzenia własnych obiektów ListenableFuture, a polecenie Surface odbywa się teraz za pomocą nowego obiektu SurfaceRequest. Metoda Preview.getPreviewSurfaceProvider() została usunięta z powodu nieprawidłowego użycia, gdy klasa Preview jest sparowana z innymi klasami, takimi jak PreviewView. (I20105)
• Argumenty, które były wcześniej przekazywane w parametrach ImageCapture.OnImageSavedCallback.onError() i ImageCapture.OnImageCapturedCallback.onError(), zostały zastąpione pojedynczym argumentem ImageCaptureException, który nadal zawiera wszystkie informacje, które były przekazywane wcześniej.
• Argument pliku, który był wcześniej przekazywany w parametry ImageCapture.OnImageSavedCallback.onImageSaved(), został usunięty. (I750d2)
• Interfejs API został zaktualizowany. Metody getZoomRatio(), getMaxZoomRatio(), getMinZoomRatio() i getLinearZoom() interfejsu CameraInfo zostały połączone w jedną metodę getZoomState(), która zwraca instancję ZoomState. (Ib19fe)

Rozszerzenia aparatu w wersji 1.0.0-alfa06

22 stycznia 2020 r.

Usługa androidx.camera:camera-extensions:1.0.0-alpha06 została zwolniona. Wersja 1.0.0-alpha06 zawiera te zatwierdzenia

Aktualizacje

• Wprowadzono różne poprawki i aktualizacje umożliwiające obsługę zmian w Camera Core i Camera2.

Widok z aparatu, wersja 1.0.0-alpha06

Styczeń 22, 2020

androidx.camera:camera-view:1.0.0-alpha06 został zwolniony. Wersja 1.0.0-alpha06 zawiera te zatwierdzenia

Aktualizacje

• Wprowadzono różne poprawki i aktualizacje umożliwiające obsługę zmian w Camera Core i Camera2.

Camera-Extensions w wersji 1.0.0-alpha05

18 grudnia 2019 r.

androidx.camera:camera-extensions:1.0.0-alpha05 został zwolniony. Wersja 1.0.0-alfa05 zawiera te zatwierdzenia.

Poprawki błędów

• Zaktualizowano, aby pasowała do wewnętrznych interfejsów API aparatu.

Widok z kamery, wersja 1.0.0-alpha05

18 grudnia 2019 r.

Usługa androidx.camera:camera-view:1.0.0-alpha05 została zwolniona. Wersja 1.0.0-alpha05 zawiera te zatwierdzenia.

Znane problemy

• Podczas korzystania z PodglądView format obrazu może być nieprawidłowy (b/146215202).

Nowe funkcje

• Wprowadziliśmy nową klasę PreviewView.TextureViewImplementation, która synchronizuje cykl życia SurfaceTexture z korzystaniem przez aparat z powierzchni TextureView.

Rozszerzenia aparatu w wersji 1.0.0-alfa04

4 grudnia 2019

Usługa androidx.camera:camera-extensions:1.0.0-alpha04 została zwolniona. Wersja 1.0.0-alpha04 rozszerzeń aparatu zawiera te commity

Zmiany interfejsu API

• Sprawdzanie dostępności i włączania rozszerzenia przyjmuje teraz parametr wejściowy CameraSelector. Musi to być ten sam CameraSelector, który jest używany do powiązania przypadku użycia.

  val cameraSelector = CameraSelector.DEFAULT_BACK_CAMERA
  val builder = ImageCapture.Builder()
  val bokehImageCaptureExtender = BokehImageCaptureExtender.create(builder)
  if (bokehImageCaptureExtender.isExtensionAvailable(cameraSelector)) {
      bokehImageCaptureExtender.enableExtension(cameraSelector)
  }
  val imageCapture = builder.build()
  mCameraProvider?.bindToLifecycle(this, cameraSelector, imageCapture)
  

• Zanim zaczniesz korzystać z biblioteki rozszerzeń, musisz zainicjować rozszerzenia.

  val availability = ExtensionsManager.init()
  Futures.addCallback<ExtensionsManager.ExtensionsAvailability>(
     availability,
     object : FutureCallback<ExtensionsManager.ExtensionsAvailability> {
         override fun onSuccess(availability: ExtensionsManager.ExtensionsAvailability?) {
             // Ready to make extensions calls
         }
         override fun onFailure(throwable: Throwable) {
             // Extensions could not be initialized
         }
     },
     Executors.newSingleThreadExecutor()
  )
  

Widok z kamery, wersja 1.0.0-alpha04

4 grudnia 2019

Usługa androidx.camera:camera-view:1.0.0-alpha04 została zwolniona. Wersja 1.0.0-alpha04 pakietu camera-view zawiera te commity

Zmiany interfejsu API

• Klasa PreviewView służy do łatwego wyświetlania danych wyjściowych z przypadku użycia podglądu w aplikacji.

• Element PreviewView można uwzględnić w układzie:

  <androidx.camera.view.PreviewView
    android:id="@+id/preview_view"
    … />
  

• PreviewView udostępnia element PreviewSurfaceProvider umożliwiający łatwe połączenie z przypadkiem użycia w wersji testowej

  preview.setPreviewSurfaceProvider(previewView.previewSurfaceProvider)
  

• W nazwach interfejsów API „ZoomLevel” jest teraz „ZoomRatio”

• Zmieniono możliwość braku wartości niektórych parametrów metody

Camera-Extensions i Camera-View w wersji 1.0.0-alpha03

9 października 2019 r.

androidx.camera:camera-extensions:1.0.0-alpha03 i androidx.camera:camera-view:1.0.0-alpha03 są dostępne. Oto kompilacje uwzględnione w camera-extensions:1.0.0-alpha03, a tutaj kompilacje uwzględnione w camera-view:1.0.0-alpha03.

Nowe funkcje

• Dodano inicjalizator kontekstu dla rozszerzeń. Wersja rozszerzeń została zwiększona do 1.1.0

Camera-Extensions i Camera-View w wersji 1.0.0-alpha02

5 września 2019 r.

Zasoby androidx.camera:camera-extensions:1.0.0-alpha02 i androidx.camera:camera-view:1.0.0-alpha02 są dostępne. Te zobowiązania zawarte w rozszerzeniach dotyczących aparatu to 1.0.0-alfa02. Obejmują zobowiązania obejmujące widok z kamery: 1.0.0-alfa02.

• Dodano testy, które sprawdzają, czy PreviewImageProcessorImpl prawidłowo implementuje sygnatury czasowe.
• Napraw błąd testu ExtensionTest na Nexusie 5 (poziom API 21) i upewnij się, że podgląd jest dostępny.

Rozszerzenia aparatu i widok aparatu w wersji 1.0.0-alfa01

7 sierpnia 2019 r.

Zasoby androidx.camera:camera-extensions:1.0.0-alpha01 i androidx.camera:camera-view:1.0.0-alpha01 są dostępne. Oto kompilacje zawarte w camera-extensions:1.0.0-alpha01, a tutaj kompilacje zawarte w camera-view:1.0.0-alpha01.

• Nowa biblioteka dla przyszłych rozszerzeń aparatu, która umożliwi dostęp do efektów na obsługiwanych urządzeniach. Ta biblioteka jest w trakcie opracowywania.
• Nowe zajęcia z widoku z aparatu. Ta biblioteka jest w trakcie opracowywania.