CameraX

CameraX è un componente aggiuntivo di Jetpack che semplifica l'aggiunta di funzionalità della fotocamera alla tua app. La libreria fornisce una serie di correzioni di compatibilità e soluzioni alternative per contribuire a rendere l'esperienza dello sviluppatore coerente su molti dispositivi.

Questa tabella elenca tutti gli elementi nel gruppo androidx.camera.

Elemento Release stabile Candidato per la release Versione beta Versione alpha
camera-camera2 1.4.0 - - 1.5.0-alpha03
camera-core 1.4.0 - - 1.5.0-alpha03
camera-compose - - - 1.5.0-alpha03
effetti-fotocamera 1.4.0 - - 1.5.0-alpha03
estensioni-videocamera 1.4.0 - - 1.5.0-alpha03
query-combinazione-funzionalità-fotocamera - - - 1.5.0-alpha03
camera-feature-combination-query-play-services - - - 1.5.0-alpha03
ciclo di vita della fotocamera 1.4.0 - - 1.5.0-alpha03
camera-mlkit-vision 1.4.0 - - 1.5.0-alpha03
visualizzazione-fotocamera 1.4.0 - - 1.5.0-alpha03
fotocamera-mirino - - 1.3.0-beta02 1.4.0-alpha07
video-camera 1.4.0 - - 1.5.0-alpha03
Questa libreria è stata aggiornata l'ultima volta il 30 ottobre 2024

Test del dispositivo

CameraX viene testato su molti dispositivi nel nostro laboratorio. Per visualizzare un elenco dei dispositivi attualmente nel lab, vedi Dispositivi testati in lab CameraX.

Dichiarazione delle dipendenze

Per aggiungere una dipendenza da CameraX, devi aggiungere il repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il Repository Maven di Google.

Aggiungi le dipendenze per gli elementi necessari nel file build.gradle per la tua app o il tuo modulo:

Groovy

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}"
}

Kotlin

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}")
}

Feedback

Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se riscontri nuovi problemi o hai idee per migliorare questa raccolta. Prima di crearne uno nuovo, dai un'occhiata ai problemi esistenti in questa raccolta. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.

Crea un nuovo numero

Per ulteriori informazioni, consulta la documentazione di Issue Tracker.

Versione 1.0 di Componi con il mirino della fotocamera

Versione 1.0.0-alpha02

12 giugno 2024

Viene rilasciato androidx.camera:camera-viewfinder-compose:1.0.0-alpha02. La versione 1.0.0-alpha02 contiene questi commit.

Versione 1.0.0-alpha01

14 maggio 2024

Viene rilasciato androidx.camera:camera-viewfinder-compose:1.0.0-alpha01. La versione 1.0.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Nuova libreria. Questa libreria introduce un composable nativo di Compose per il mirino, che può essere utilizzato con CameraX e Camera2. Il mirino componibile supporta diversi rapporti di aspetto e la gestione degli eventi tocco.

Versione 1.4 del mirino della videocamera

Versione 1.4.0-alpha07

12 giugno 2024

Vengono rilasciate le versioni androidx.camera:camera-viewfinder:1.4.0-alpha07 e androidx.camera:camera-viewfinder-core:1.4.0-alpha07. La versione 1.4.0-alpha07 contiene questi commit.

Versione 1.4.0-alpha06

14 maggio 2024

androidx.camera:camera-viewfinder:1.4.0-alpha06 e androidx.camera:camera-viewfinder-core:1.4.0-alpha06 vengono rilasciati. La versione 1.4.0-alpha06 contiene questi commit.

Modifiche all'API

  • Rinomina gli enum ImplementationMode di Viewfinder per riflettere meglio le implementazioni sottostanti e aggiungi costanti fisse per TransformationInfo.sourceRotation. (Ic6149)
  • È stato aggiunto ZoomGestureDetector.ZoomEvent per incapsulare gli stati di un gesto di zoom. (I84cdf)

Versione della videocamera 1.5

Versione 1.5.0-alpha03

30 ottobre 2024

Viene rilasciato androidx.camera:camera-*:1.5.0-alpha03. La versione 1.5.0-alpha03 contiene questi commit.

Modifiche all'API

  • Aggiungi API di formato di output per RAW e RAW + JPEG ImageCapture, il controllo delle funzionalità del dispositivo è esposto in ImageCaptureCapabilities#getSupportedOutputFormats. OUTPUT_FORMAT_RAW serve per acquisire immagini RAW, ovvero in formato Adobe DNG, mentre OUTPUT_FORMAT_RAW_JPEG serve per acquisire contemporaneamente immagini RAW e JPEG. La nuova API ImageCapture#takePicture viene utilizzata per l'acquisizione simultanea di immagini e deve fornire due OutputFileOptions, il primo per l'immagine RAW e il secondo per l'immagine JPEG. (Ib0f3d).

Correzioni di bug

  • È stato risolto il problema di sottoesposizione per anteprima e video sui dispositivi TCL quando VideoCapture è abilitato. (Id7a64)
  • È stato risolto il problema per cui l'attivazione di startFocusMetering con PreviewView.getMeteringPointFactory non restituisce le coordinate del sensore corrette quando è attivato un effetto o quando sono associati quattro casi d'uso (condivisione in streaming). (I916c5, b/345993685)
  • È stato corretto il problema per cui l'evento VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE non viene attivato durante la registrazione di un video e lo spazio di archiviazione disponibile non è sufficiente. (I35779, b/356399842)

Versione 1.5.0-alpha02

2 ottobre 2024

androidx.camera:camera-*:1.5.0-alpha02 viene rilasciato. La versione 1.5.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Nuove API per eseguire query sulle funzionalità della fotocamera supportate dal dispositivo. Ad esempio, è possibile controllare se è possibile attivare contemporaneamente HDR e 60 f/s. Sono inclusi due elementi: query-combinazione-funzionalità-fotocamera e query-combinazione-funzionalità-fotocamera-play-services. Si tratta di una versione compatibile dell'API CameraManager#getCameraDeviceSetup#isSessionConfigurationSupported di Camera2 con dati aggiuntivi forniti da Google Play Services.

Correzioni di bug

  • È stato risolto il problema relativo alla frequenza frame target Preview/VideoCapture sui dispositivi di livello LEGACY. La frequenza frame target impostata tramite l'API setTargetFrameRate o Camera2Interop è sempre stata sovrascritta con il valore fornito da AeFpsRangeLegacyQuirk. Con questa correzione, la libreria di CameraX rispetterà il valore impostato tramite l'API setTargetFrameRate o Camera2Interop. (Ie2d32)
  • Aggiunta di funzionalità di flash/torcia/3A per le acquisizioni di immagini con CameraEffect. Le acquisizioni di immagini con CameraEffect ora dovrebbero avere le stesse elaborazioni di pre e post-acquisizione (ad es. attivazione flash, convergenza 3A e così via, se applicabile) delle acquisizioni di immagini senza CameraEffect. (I5ff30)
  • Dimensioni di output problematiche escluse per ImageAnalysis sul dispositivo Samsung SM-A057G. Quando ImageAnalysis utilizza una risoluzione maggiore o uguale a 1920 x 1440, si verifica un problema di anteprima nera. È stato applicato ExcludedSupportedSizesQuirk al dispositivo SM-A057G per evitare il problema. (I63dfe, b/365877975)
  • È stato risolto il problema di frequenza frame target di Preview/VideoCapture quando il meccanismo di condivisione dello streaming è abilitato internamente per condividere uno stream su Preview e VideoCapture. (I4fdac)
  • È stata attivata la soluzione alternativa per risolvere il problema relativo ai metadati delle immagini JPEG errati sui dispositivi Samsung S10e e S10+. Con la correzione, CameraX può salvare correttamente l'immagine JPEG oppure possono essere restituiti oggetti Bitmap corretti quando viene chiamata la funzione ImageProxy.toBitmap() su questi dispositivi se si verifica il problema dei metadati dell'immagine JPEG errati. (Iae493, b/356428987)
  • Estensioni disattivate per la fotocamera posteriore del Samsung A52s il cui ID è 0, perché potrebbero verificarsi arresti anomali nativi durante l'acquisizione di immagini HDR e la configurazione delle sessioni di acquisizione potrebbe non riuscire per le modalità BOKEH o FACE_RETOUCH. (I03ec9, b/364152642)
  • È stato corretto il problema per cui l'evento VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE non viene attivato durante la registrazione di un video e lo spazio di archiviazione disponibile non è sufficiente. (Ia5b4f, b/356399842)
  • È stato risolto il problema per cui il secondo tentativo di registrazione video non andava a buon fine su Oppo A5 (CPH1931). (I181d6)

Versione 1.5.0-alpha01

4 settembre 2024

androidx.camera:camera-*:1.5.0-alpha01 viene rilasciato. La versione 1.5.0-alpha01 contiene questi commit.

Modifiche all'API

  • Fornire l'API per configurare le impostazioni di composizione per l'acquisizione video con doppia fotocamera simultanea. Le impostazioni includono il valore alpha per la miscelazione, l'offset nelle coordinate x e y, la scala della larghezza e dell'altezza della finestra di visualizzazione del frame della videocamera. L'offset, la larghezza e l'altezza sono specificati nelle coordinate del dispositivo normalizzate. (Ia2b8a)
  • CameraProvider.getCameraInfo è stata esposta come API formale. (I901cd)
  • È stata aggiunta l'API PendingRecording.withAudioEnabled(boolean initialMuted) per controllare lo stato di disattivazione audio iniziale. (I635c3, b/354829267)

Correzioni di bug

  • È stato corretto l'arresto anomalo quando bindToLifecycle viene invocato con un LifecycleOwner distrutto. (I6e6d8)
  • L'anteprima fissa ha lo schermo nero nella fotocamera anteriore durante l'associazione con VideoCapture su Motorola Edge 20 Fusion. (I1fe88)
  • È stata ottimizzata la configurazione per il rilevamento dei gesti di zoom in PreviewView per migliorare la fluidità. (I04ffc)

Versione della videocamera 1.4

Versione 1.4.0

30 ottobre 2024

androidx.camera:camera-*:1.4.0 viene rilasciato. La versione 1.4.0 contiene questi commit.

Modifiche importanti dalla versione 1.3.0

CameraX 1.4.0 è ricca di aggiornamenti entusiasmanti! Ecco un riepilogo:

Funzionalità principale: HDR a 10 bit:

  • Scatta foto e video HDR straordinari con facilità.
  • Supporta la codifica HLG e HEVC a 10 bit.
  • Goditi l'anteprima HDR a 10 bit e esegui query sulle funzionalità del dispositivo.
  • Funziona con immagini UltraHDR e video HDR su una gamma crescente di dispositivi.

Altre funzionalità interessanti:

  • Estensioni Kotlin: sono state aggiunte le funzioni di sospensione takePicture e awaitInstance.
  • Effetti in tempo reale: applica effetti come filigrane e l'evidenziazione di oggetti.
  • API CameraController: nuovi controlli per la configurazione dell'acquisizione video.
  • Stabilizzazione dell'anteprima: esegui query sulla funzionalità del dispositivo e attiva la stabilizzazione.
  • Miglioramenti a VideoCapture: controllo più preciso della qualità e accesso a risoluzioni più elevate.
  • Integrazione di CameraX Extensions: perfetta integrazione con VideoCapture e nuove funzionalità ImageCapture.
  • API Shutter Sound: controlla facilmente i requisiti relativi al suono dell'otturatore a livello di regione.
  • Flash schermo: foto migliorate in condizioni di scarsa illuminazione per le fotocamere anteriori.
  • API di metadati delle estensioni della fotocamera: API di supporto per regolare l'efficacia delle estensioni e ricevere una notifica della modalità Estensioni corrente in ExtensionMode#AUTO. Puoi trovare altre correzioni di bug nei nostri annunci relativi alle versioni beta e RC.

Versione 1.4.0-rc04

16 ottobre 2024

androidx.camera:camera-*:1.4.0-rc04 viene rilasciato. La versione 1.4.0-rc04 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema per cui la chiamata di startFocusMetering con PreviewView.getMeteringPointFactory non ottiene le coordinate corrette del sensore quando viene attivato un effetto o quando sono associati quattro casi d'uso (condivisione dello streaming). (I916c5, b/345993685)

Versione 1.4.0-rc03

2 ottobre 2024

androidx.camera:camera-*:1.4.0-rc03 viene rilasciato. La versione 1.4.0-rc03 contiene questi commit.

Correzioni di bug

  • Aggiunta di funzionalità di flash/torcia/3A per le acquisizioni di immagini con CameraEffect. Le acquisizioni di immagini con CameraEffect ora dovrebbero avere le stesse elaborazioni di pre e post-acquisizione (ad es. attivazione flash, convergenza 3A e così via, se applicabile) delle acquisizioni di immagini senza CameraEffect. (I5ff30)
  • È stata ottimizzata la fluidità della funzionalità pizzica per aumentare lo zoom in PreviewView (I04ffc)
  • Disaccoppia Ultra HDR dalla funzionalità di output a 10 bit, poiché il supporto della funzionalità Ultra HDR non richiede più sui dispositivi una funzionalità di output a 10 bit. (I96ff2, I0c3b3)

Versione 1.4.0-rc02

18 settembre 2024

androidx.camera:camera-*:1.4.0-rc02 viene rilasciato. La versione 1.4.0-rc02 contiene questi commit.

Correzioni di bug

  • È stato corretto l'arresto anomalo quando bindToLifecycle viene invocato con un LifecycleOwner distrutto. (I6e6d8)
  • È stata aggiunta l'animazione di visibilità in ScreenFlashView per ScreenFlash#apply, che corregge anche i bug dovuti al completamento della modifica della luminosità in modo asincrono dopo un po' di tempo. (I37cdb)
  • È stata migliorata la fluidità dello zoom tramite l'override delle impostazioni di zoom nel framework sui dispositivi supportati.

Versione 1.4.0-rc01

7 agosto 2024

androidx.camera:camera-*:1.4.0-rc01 viene rilasciato. La versione 1.4.0-rc01 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto CameraInfo.getCameraInfo sperimentale per fornire informazioni specifiche sulla fotocamera senza dover associare casi d'uso alla fotocamera. (I550d1)

Modifiche alle API

  • Sono state aggiunte le API PreviewView.getScreenFlash e PreviewView.setScreenFlashOverlayColor per i casi in cui ScreenFlashView non viene aggiunto esplicitamente. (I43945)

Correzioni di bug

  • Sono stati risolti i problemi di esposizione e tinta di colore durante le immagini acquisite con il flash abilitato in condizioni di scarsa illuminazione e con il caso d'uso di Video Capture associato. (Ic9814)
  • È stato risolto il problema per cui l'interruzione di una richiesta takePicture con le Estensioni abilitate potrebbe non riuscire a ottenere un risultato e la richiesta takePicture successiva potrebbe non funzionare più. (Iae78f)
  • È stato risolto un problema di perdita di memoria che si verifica quando le Estensioni sono attivate. (Iab276)
  • È stato risolto un malfunzionamento delle estensioni CameraX su dispositivi come Pixel 7/8 e la serie Samsung Galaxy S24. Il problema, derivante da un problema di conversione Camera2OutputConfigImpl in modalità di rilascio, si è verificato dopo l'upgrade di AGP alla versione 8.5.1 e l'attivazione della minimizzazione. (I99598, b/354824993)

Versione 1.4.0-beta02

12 giugno 2024

androidx.camera:camera-*:1.4.0-beta02 viene rilasciato. La versione 1.4.0-beta02 contiene questi commit.

Modifiche alle API

  • Analogamente a VideoCapture, aggiungi setMirrorMode per il caso d'uso Anteprima. Supporterà la modalità di mirroring ON e OFF per lo stream di anteprima tramite OutputConfiguration.setMirrorMode a partire dall'API 33 e versioni successive. Per le API precedenti, non verrà eseguita alcuna operazione. (I821f4)

Correzioni di bug

  • È stato risolto il problema per cui le app non riescono a scattare foto su Samsung Tab A8 quando ImageCapture seleziona 1920 x 1080 nella combinazione Preview + VideoCapture + ImageCapture UseCase. (I5a463, b/336925549)
  • La registrazione continua potrebbe non riuscire a continuare dopo il cambio di videocamera. (Icb0a1)

Versione 1.4.0-beta01

14 maggio 2024

androidx.camera:camera-*:1.4.0-beta01 viene rilasciato. La versione 1.4.0-beta01 contiene questi commit.

Modifiche all'API

  • È stato aggiunto ZoomGestureDetector.ZoomEvent per incapsulare gli stati di un gesto di zoom. (I84cdf)

Correzioni di bug

  • È stato corretto un bug per cui, in alcuni dispositivi, l'acquisizione e il tocco per mettere a fuoco continuano a non utilizzare i valori di modalità di stabilizzazione o FPS delle richieste ripetute, che potrebbero ricreare la sessione di acquisizione e causare problemi di latenza o blocco dell'anteprima. (I7dc0b)
  • È stato corretto un bug che impediva la selezione delle risoluzioni elevate quando CameraEffect è attivo su alcuni dispositivi. (ad es. 4000 x 3000 su Samsung A32 5G). (Ie3ed3, b/337336152)
  • È stato corretto un arresto anomalo durante lo scatto di foto con Anteprima quando ImageCapture e VideoCapture(UHD) sono associati su Pixel 4XL API29. (I5b288)
  • Supporto dei dispositivi virtuali: il contesto passato a ProcessCameraProvider manterrà l'ID dispositivo per garantire la funzionalità in un ambiente di dispositivo virtuale. (I5ba48)

Versione 1.4.0-alpha05

17 aprile 2024

androidx.camera:camera-*:1.4.0-alpha05 viene rilasciato. La versione 1.4.0-alpha05 contiene questi commit.

Nuove funzionalità

  • ProcessCameraProvider è stato convertito in implementazione Kotlin. (I46d4f)
  • Sono state aggiunte le funzioni di sospensione ImageCapture.takePicture per consentire la chiamata in modo idiomatico Kotlin. (I920be)

Modifiche all'API

  • Aggiungi le API di formato di output a ImageCapture e il metodo getSupportedOutputFormats a ImageCaptureCapabilities per eseguire query sulle funzionalità del dispositivo. Il valore predefinito del formato di output è OUTPUT_FORMAT_JPEG, che acquisisce le immagini SDR in formato JPEG. Quando il dispositivo supporta Ultra HDR e il formato di output è impostato su OUTPUT_FORMAT_JPEG_ULTRA_HDR, CameraX acquisirà le immagini compresse Ultra HDR utilizzando il formato immagine JPEG/R. Il formato è compatibile con le versioni precedenti del formato JPEG SDR e supporta il rendering HDR dei contenuti. Ciò significa che sulle app o sui dispositivi meno recenti le immagini vengono visualizzate senza interruzioni come normali file JPEG; nelle app e sui dispositivi che sono stati aggiornati per supportare completamente il formato, le immagini vengono visualizzate in HDR. (I5de50)
  • Aggiungi PhysicalCameraInfo in CameraInfo per eseguire query sulle informazioni della videocamera fisica e aggiungi il set/get dell'ID della videocamera fisica in CameraSelector (Ic5b90)
  • Sostituisci CameraController#COORDINATE_SYSTEM_VIEW_REFERENCED con ImageAnalysis#COORDINATE_SYSTEM_VIEW_REFERENCED. Il valore della costante rimane lo stesso. per consolidare tutte le costanti in un unico posto. (I890bb)
  • La nuova API RetryPolicy consente agli sviluppatori di personalizzare il comportamento di ripetizione per l'inizializzazione di CameraX. (I36dd2)
  • Abilita la creazione dell'oggetto ImageCaptureLatencyEstimate per facilitare la testabilità (Iaba99)
  • Aggiungi un ImageAnalysis#COORDINATE_SYSTEM_SENSOR. Quando viene utilizzato, MlKitAnalyzer restituisce le coordinate nel sistema di coordinate del sensore della fotocamera. (I3ec61).
  • API di metadati delle estensioni esposte. Le nuove interfacce CameraExtensionsInfo e CameraExtensionsControl consentono alle applicazioni di monitorare e regolare le impostazioni di sicurezza delle estensioni. Le applicazioni possono ottenere l'istanza CameraExtensionsInfo o CameraExtensionsControl tramite i metodi ExtensionsManager#getCameraExtensionsInfo() o ExtensionsManager#getCameraExtensionsControl() appena aggiunti. (I28e1a)
  • È stata aggiunta ProcessCameraProvider.awaitInstance, una versione sospesa di ProcessCameraProvider.getInstance (Ib22b9)
  • Aggiungi un'API PreviewView#getSensorToViewTransform(). La matrice rappresenta la trasformazione dalle coordinate del sensore della videocamera alle coordinate di PreviewView. Questo può essere utilizzato per trasformare le coordinate da un UseCase all'altro. Ad esempio, la trasformazione delle coordinate degli oggetti rilevati in ImageAnalysis in un overlay PreviewView. (I947ab)
  • Rendi l'API camera-viewfinder-core più generica in modo che possa essere utilizzata da camera-viewfinder e camera-viewfinder-compose. (I1e295)
  • Aggiungi la funzione getSurface a ViewfinderSurfaceRequest. (I781a0)
  • Utilizza camera-viewfinder-core in camera-viewfinder e ritira ViewfinderSurfaceRequest e CameraViewfinder. (I6198c)
  • È stato aggiunto il metodo ZoomGestureDetector che interpreta i gesti di ridimensionamento configurati appositamente per le attività di zoom tramite pizzico. (Ifafbf)

Correzioni di bug

  • È stato risolto il problema di selezione della risoluzione ImageAnalysis relativo all'impostazione della risoluzione target predefinita dell'analizzatore: la risoluzione target è stata mantenuta erroneamente a 640 x 480 anche se le applicazioni hanno impostato un'impostazione di risoluzione predefinita dell'analizzatore diversa. Se le applicazioni riscontrano questo problema (da 1.3.0 a 1.3.2) e non possono eseguire l'upgrade per utilizzare le release più recenti che contengono la soluzione, è possibile risolvere il problema impostando direttamente un ResolutionSelector con la risoluzione preferita e un AspectRatioStrategy corrispondente a ImageAnalysis UseCase. (I81f72, b/330091012)
  • È stato risolto un problema che causava la mancata esecuzione della richiesta takePicture in coda se la richiesta corrente non va a buon fine. (Ie0801)
  • Applica il controllo dei dati JPEG non validi ai dispositivi Vivo X60 e X60 Pro. In questo modo è possibile risolvere un problema di immagini di dimensioni insolitamente grandi su questi dispositivi. (I82247, b/288828159)
  • È stato risolto il problema errato dei metadati dell'immagine JPEG sui dispositivi Samsung A24. Con la correzione, CameraX può salvare correttamente l'immagine JPEG o possono essere restituiti oggetti Bitmap corretti quando viene chiamata la funzione ImageProxy.toBitmap() sui dispositivi Samsung A24. (I8d6eb, b/309005680)
  • Applica il controllo dei dati JPEG non validi a tutti i dispositivi Samsung se l'immagine acquisita supera i 10 MB. In questo modo puoi risolvere il problema delle immagini eccessivamente grandi sui dispositivi Samsung. (Ic2a65, b/288828159)
  • È stato rimosso il supporto di ImageAnalysis nelle Estensioni CameraX perché molte implementazioni delle Estensioni degli OEM non funzionano bene con ImageAnalysis e potrebbero causare problemi incoerenti. (I2d926)

Versione 1.4.0-alpha04

24 gennaio 2024

androidx.camera:camera-*:1.4.0-alpha04 viene rilasciato. La versione 1.4.0-alpha04 contiene questi commit.

Nuove funzionalità

  • Nuovo elemento: effetti-fotocamera: una libreria per applicare effetti in tempo reale all'output di CameraX, inclusi Preview, VideoCapture e/o ImageCapture. Questo elemento contiene implementazioni OpenGL dell'API CameraEffect che manipola l'output della fotocamera in modo efficiente.
  • OverlayEffect: per disegnare overlay con l'API Canvas di Android. In questo modo, l'app può applicare una filigrana o evidenziare gli oggetti rilevati sulle uscite della fotocamera.
  • DynamicRange API per il caso d'uso Anteprima: ora l'intervallo dinamico può essere impostato sul caso d'uso Anteprima, indipendentemente dal caso d'uso Video. Ciò consente intervalli dinamici HDR come HLG10 per solo Anteprima. In CameraInfo sono disponibili anche nuove API per eseguire query sulle gamme dinamiche supportate da ogni fotocamera.

Modifiche all'API

  • ScreenFlashUiCompleter rinominato in ScreenFlashListener e spostato ScreenFlashUiCompleter#getExpirationTimeMillis nel parametro expirationTimeMillis di ScreenFlash#apply. (I13944)
  • Sono state aggiunte nuove API per consentire di impostare la gamma dinamica nel caso d'uso Anteprima e per eseguire query sulle gamme dinamiche supportate da ogni fotocamera. In questo modo, le gamme dinamiche HDR, come HLG10, possono essere utilizzate solo con il caso d'uso Anteprima, senza che sia più necessario vincolare contemporaneamente un VideoCapture. (If25e3)
  • getMirroring() rinominato in isMirroring() (I47063)
  • È stato aggiunto il supporto della stima della latenza di acquisizione di foto in tempo reale in CameraX. Le estensioni della fotocamera consentono alle applicazioni di utilizzare un'API che fornisce una stima del tempo necessario per un'acquisizione. La stima tiene conto delle condizioni ambientali attuali, dello stato della videocamera e include il tempo impiegato per elaborare le richieste di acquisizione multi-frame, nonché il tempo aggiuntivo necessario per la codifica dei buffer elaborati, se necessario. (I05c3a)
  • ScreenFlashUiControl è stato rinominato in ScreenFlash, ScreenFlashUiControl#applyScreenFlashUi in ScreenFlash#apply, ScreenFlashUiControl#clearScreenFlashUi in ScreenFlash#clear e abbiamo aggiunto il metodo getScreenFlashUiApplyTimeoutSeconds anziché esporre direttamente SCREEN_FLASH_UI_APPLY_TIMEOUT_SECONDS. (Iccdd0)

Correzioni di bug

  • Correzione di una perdita di memoria che causava il mancato rilascio di attività o frammenti quando le estensioni sono abilitate (I14215)
  • È stato risolto il problema per cui getZoomRatio restituiva erroneamente un valore diminuito durante l'applicazione di un rapporto di zoom crescente. (I4aa0d, b/317543616)
  • L'evento ImageCapture#ScreenFlash#clear viene richiamato immediatamente quando ImageCapture viene slegato o la fotocamera è chiusa, corregge anche alcuni bug in cui non viene mai richiamato a causa di acquisizioni in questi scenari non completate correttamente. (If99f9)
  • È stato corretto l'errore che si verifica quando il ciclo di vita viene interrotto prima del completamento della richiesta takePicture (Idf017, b/306202751)
  • È stato risolto il problema per cui l'anteprima della fotocamera diventa nera quando le Estensioni sono attivate su alcuni dispositivi (I1ffd0)
  • È stata corretta la durata errata della registrazione video sui dispositivi che utilizzano il SoC Snapdragon 778G. (If6aa7, b/316057919)

Versione 1.4.0-alpha03

13 dicembre 2023

androidx.camera:camera-*:1.4.0-alpha03 viene rilasciato. La versione 1.4.0-alpha03 contiene questi commit.

Nuove funzionalità

  • È stato aggiunto CameraInfo.mustPlayShutterSound per indicare se deve essere riprodotto un suono dell'otturatore in conformità con le restrizioni regionali. (Ifda84)
  • Sono stati aggiunti OnImageCapturedCallback.onCaptureStarted e OnImageSavedCallback.onCaptureStarted per inviare una notifica quando la videocamera ha iniziato a esporre un fotogramma. A questo punto, ti consigliamo di riprodurre l'audio dell'otturatore o l'animazione dell'otturatore. (Ic49b3)
  • È stato aggiunto il supporto della funzionalità Flash schermo in CameraX per l'acquisizione di immagini con la fotocamera anteriore. CameraX si occuperà della gestione dell'API a livello di framework e sincronizzerà la temporizzazione con le modifiche all'interfaccia utente dell'applicazione, se necessario (ad es. attivazione dell'anteprima AE dopo la modifica del colore/della luminosità dello schermo dell'app). Le app dovranno solo aggiungere le implementazioni lato UI nell'interfaccia ScreenFlashUiControl fornita a CameraX. (I8ae84)
  • È stato aggiunto il supporto per l'implementazione della funzionalità Flash schermo a livello di interfaccia utente in CameraX. Le app potranno ottenere un'implementazione ImageCapture.ScreenFlashUiControl di base da PreviewView o dalla nuova ScreenFlashView aggiunta che aggiungerà una visualizzazione sovrapposta monocolore e massimizzerà la luminosità dello schermo durante l'acquisizione di foto in flash di schermo. (I1810e)

Modifiche all'API

  • Supporta nuove funzionalità delle estensioni(visualizzazione post-visualizzazione e avanzamento del processo): sono state aggiunte le API ImageCapture#getImageCaptureCapabilities() per consentire alle app di eseguire query sulle funzionalità della visualizzazione post-visualizzazione e di acquisire il callback di avanzamento del processo. Le app possono attivare il postview utilizzando ImageCapture.Builder#setPostviewEnabled(). Le dimensioni post-visualizzazione possono essere selezionate utilizzando ImageCapture.Builder#setPostviewResolutionSelector(). Quando viene invocato takePicture(), onPostviewBitmapAvailable e onCaptureProcessProgressed possono essere implementati in OnImageSavedCallback o OnImageCapturedCallback per ottenere la postview ed elaborare la notifica di avanzamento, se supportata. (I5cd88)
  • API per calcolare la trasformazione delle coordinate dal sensore al buffer corrente, con un flag che indica se la superficie contiene le informazioni sull'orientamento della fotocamera. (I59096)
  • Esponi l'API da sottoporre a query PreviewCapabitlity in Anteprima UseCase. (Ie5b6c)
  • Sono state aggiunte API per supportare più qualità per VideoCapture. Recorder.Builder#setVideoCapabilitiesSource(int) può essere utilizzato con VIDEO_CAPABILITIES_SOURCE_CODEC_CAPABILITIES per creare un'istanza Recorder che supporta più qualità rispetto a VIDEO_CAPABILITIES_SOURCE_CAMCORDER_PROFILE. Un caso d'uso comune è quando l'applicazione tenta di registrare video UHD quando possibile, ma il CamcorderProfile del dispositivo non include impostazioni UHD, anche se il codec è in grado di registrare video UHD. (Iedbe2, b/263961771)
  • Aggiungi il getter/setter del formato di output ImageAnalysis a CameraController. (I9a96c, b/308240643)

Correzioni di bug

  • Da Fotocamera 1.3.1: è stato migliorato il rendimento di ProcessCameraProvider#bindToLifecycle(). La modifica più importante è l'ottimizzazione del processo di identificazione delle combinazioni di dimensioni più adatte per UseCases. I risultati ottimali variano in base alle combinazioni specifiche di UseCase e al numero di dimensioni di output supportate per i dispositivi di destinazione. (I454f2)
  • Consenti l'utilizzo di VideoCapture quando le estensioni sono attive. (I91f32)
  • È stato risolto il problema relativo alle immagini JPEG di grandi dimensioni acquisite sui dispositivi Samsung della serie A71 e M51. Le immagini JPEG acquisite contengono dati di spaziatura interna di 0 ridondanti nel segmento di dati compresso JFIF. Le immagini acquisite hanno dimensioni del file molto elevate. Questi dati di spaziatura di zeri ridondanti verranno rimossi per fare in modo che le immagini acquisite abbiano dimensioni normali dei file immagine. (I01afc, b/288828159)
  • Disattiva il supporto di ImageAnalysis su Pixel per evitare il bug su Pixel che restituisce accidentalmente le dimensioni supportate di ImageAnalysis non vuote. (I7ec31)
  • È stato risolto un problema di prestazioni relativo all'aumento del carico della CPU e del consumo energetico quando le Estensioni sono attive. (Ibdccb)
  • È stato aggiunto Snapdragon 480 al CameraUseInconsistentTimebaseQuirk. In questo modo viene risolto un problema su Android 12 per i dispositivi che utilizzano questo chipset, in cui l'audio nelle registrazioni è compensato dal tempo in cui il dispositivo è in stato di sospensione. (I58010)

Versione 1.4.0-alpha02

18 ottobre 2023

androidx.camera:camera-*:1.4.0-alpha02 viene rilasciato. La versione 1.4.0-alpha02 contiene questi commit.

Modifiche all'API

  • Rinomina l'API in setCameraOpenRetryMaxTimeoutInMillisWhileResuming e rinomina l'argomento. (I72370)
  • Aggiunta di API per eseguire query sulle funzionalità del dispositivo e attivare la stabilizzazione di video/anteprime. (I87544)
  • Fornisci l'API per personalizzare il tempo di timeout massimo per i tentativi di apertura della videocamera. (I0c642).
  • Rilasciato ProcessCameraProvider.shutdownAsync come API di test pubblica per consentire l'utilizzo del provider della fotocamera di processo nelle suite di test che potrebbero dover inizializzare CameraX in modi diversi tra un test e l'altro. (I9eca7)
  • Aggiungi API per configurare la gamma dinamica, la frequenza fotogrammi e la modalità speculare di acquisizione video. (Ifb8f7)
  • Ritira OutputSize e sostituiscilo con ResolutionSelector. ResolutionSelector è un modo più completo per selezionare le risoluzioni ed è coerente con l'API camera-core. (I93abd, b/286801438)

Correzioni di bug

  • È stato risolto il problema dell'anteprima nero su Samsung Galaxy S23 Ultra 5G quando le estensioni Bokeh o Face-Retouch sono attivate con ImageAnalysis sulla fotocamera posteriore. (I2e8b1).
  • Sono stati risolti i problemi di allungamento dell'anteprima e di VideoCapture su Moto E5 Play. (73dce2)

Versione 1.4.0-alpha01

20 settembre 2023

Viene rilasciato androidx.camera:camera-*:1.4.0-alpha01. La versione 1.4.0-alpha01 contiene questi commit.

Modifiche all'API

  • Aggiungi una nuova API per accedere alle informazioni sull'ampiezza audio durante la registrazione. (Id4925)

Correzioni di bug

  • Migliora la stabilità delle estensioni assicurandoti che gli eventi di inizializzazione e deinializzazione vengano attivati nell'ordine corretto. (Ib3b8e)
  • È stato corretto l'errore di configurazione della sessione di acquisizione per il superamento della combinazione di piani supportati a causa dell'aggiunta di un'altra superficie ripetuta internamente. (Id718c)
  • È stato risolto il problema relativo alle immagini JPEG di grandi dimensioni acquisite sul dispositivo Vivo S16. Le immagini JPEG acquisite contengono dati di spaziatura di zeri ridondanti nel segmento di dati compressi JFIF. Le immagini acquisite avranno dimensioni dei file elevate. Questi dati di spaziatura di zeri ridondanti verranno rimossi per fare in modo che le immagini acquisite abbiano dimensioni normali dei file immagine. (I79505, b/299069235)
  • È stato risolto il problema per cui ImageAnalysis non può essere associato a ImageCapture e Anteprima quando alcune modalità di estensione sono attive su alcuni dispositivi. La correzione restituirà un valore corretto quando le app interrogano la disponibilità di ImageAnalysis tramite ExtensionsManager#isImageAnalysisSupported(). (I7d538)
  • Aggiorna JavaDoc in modo che corrisponda al comportamento. I comandi #setZoomRatio, #setLinearZoom e #enableTorch non completano immediatamente l'operazione, ma aspettano che la videocamera sia pronta. Sono state aggiunte anche informazioni su come ottenere il FOV massimo con l'API #takePicture. (I23588)

Versione 1.3

Versione 1.3.4

12 giugno 2024

androidx.camera:camera-*:1.3.4 viene rilasciato. La versione 1.3.4 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema per cui getZoomRatio restituiva erroneamente un valore diminuito quando veniva applicato un rapporto di zoom crescente. (I4aa0d, b/317543616)
  • È stato corretto il problema per cui la modalità di acquisizione di foto/tocco per mettere a fuoco non utilizzava i valori FPS/modalità di stabilizzazione della richiesta ripetuta, che potrebbero ricreare la sessione di acquisizione e causare problemi di latenza o blocco dell'anteprima su alcuni dispositivi. (I7dc0b)
  • È stato risolto il problema per cui la frequenza fotogrammi viene impostata su un valore più basso quando si chiama setTargetFrameRate con FRAME_RATE_RANGE_UNSPECIFIED. (I78c61)

Versione 1.3.3

17 aprile 2024

Viene rilasciato androidx.camera:camera-*:1.3.3. La versione 1.3.3 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema di selezione della risoluzione di ImageAnalysis relativo all'impostazione della risoluzione target predefinita dell'analizzatore: la risoluzione del target è stata mantenuta erroneamente a 640 x 480 anche se le applicazioni hanno impostato un'impostazione di risoluzione predefinita dell'analizzatore diversa. Se le applicazioni riscontrano questo problema (1.3.0 ~ 1.3.2) e non possono eseguire l'upgrade per utilizzare le release delle versioni più recenti che contengono la soluzione, è possibile aggirare il problema impostando direttamente un ResolutionSelector con la risoluzione preferita e un AspectRatioStrategy corrispondente all'UseCase ImageAnalysis. (I81f72, b/330091012)

Versione 1.3.2

6 marzo 2024

Viene rilasciato androidx.camera:camera-*:1.3.2. La versione 1.3.2 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema relativo ai metadati JPEG sui dispositivi Samsung A24. Ora CameraX salva le immagini con precisione e la funzione ImageProxy.toBitmap() restituisce oggetti Bitmap corretti. (I8d6eb, b/309005680)
  • L'opzione di risoluzione 9280 x 6944 è stata rimossa sui dispositivi Redmi Note 9 Pro a causa di problemi. (Ia23da)

Versione 1.3.1

13 dicembre 2023

androidx.camera:camera-*:1.3.1 viene rilasciato. La versione 1.3.1 contiene questi commit.

Correzioni di bug

È stato migliorato il rendimento di ProcessCameraProvider#bindToLifecycle(). La modifica principale è ottimizzare il processo di identificazione delle combinazioni di dimensioni più adatte per UseCases. I risultati ottimali variano in base alle combinazioni specifiche di UseCase e al numero di dimensioni di output supportate per i dispositivi di destinazione. (I454f2)

Ecco alcuni risultati di riferimento per vari scenari:

  • Quattro UseCases: Preview + ImageCapture + ImageAnalysis + VideoCapture

    • Google Pixel 7: da circa 430 ms a 60 ms
    • Samsung Galaxy S23 Ultra: circa 540 ms-45 ms
    • Samsung A53 5G: da circa 115 ms a 70 ms
  • Tre UseCases: Preview + ImageCapture + ImageAnalysis

    • Google Pixel 7: circa 9 ms-7 ms
    • Samsung Galaxy S23 Ultra: da circa 6 ms a 5 ms
    • Samsung A53 5G: circa 32 ms a 12 ms
  • È stato aggiunto Snapdragon 480 a CameraUseInconsistentTimebaseQuirk. In questo modo viene risolto un problema su Android 12 per i dispositivi che utilizzano questo chipset, in cui l'audio nelle registrazioni è compensato dal tempo in cui il dispositivo è in stato di sospensione. (I58010)

Versione 1.3.0

18 ottobre 2023

androidx.camera:camera-*:1.3.0 viene rilasciato. La versione 1.3.0 contiene questi commit.

Modifiche importanti dalla versione 1.2.0

Versione 1.3.0-rc02

20 settembre 2023

Viene rilasciato androidx.camera:camera-*:1.3.0-rc02. La versione 1.3.0-rc02 contiene questi commit.

Correzioni di bug

  • Migliora la stabilità delle estensioni assicurandoti che gli eventi di inizializzazione e deinializzazione vengano attivati nell'ordine corretto. In questo modo sono stati risolti alcuni problemi di anteprima nera quando si cambiavano le modalità di Estensioni o le videocamere. (Iddaac)
  • È stato risolto il problema per cui ImageAnalysis non può essere associato a ImageCapture e Anteprima quando alcune modalità di estensione sono attive su alcuni dispositivi. La correzione restituirà il valore corretto quando le app eseguono query sulla disponibilità di ImageAnalysis tramite ExtensionsManager#isImageAnalysisSupported(). (I7d538)
  • È stato risolto il problema per cui l'audio e il video del video registrato non erano sincronizzati quando la modalità di mirroring era attivata su Xiaomi Poco X3 NFC. (I20b4c)

Versione 1.3.0-rc01

23 agosto 2023

Viene rilasciato androidx.camera:camera-*:1.3.0-rc01. La versione 1.3.0-rc01 contiene questi commit.

Modifiche alle API

  • È stato aggiunto PendingRecording.asPersistentRecording per consentire una registrazione continua mentre il VideoCapture a cui è collegato il registratore viene riagganciato. (I517c6)

Correzioni di bug

  • È stato risolto un arresto anomalo quando uno stream viene condiviso sia con VideoCapture che con Anteprima. È stato inoltre corretto un problema di schermata nera sui dispositivi LEGACY quando la condivisione dello stream è attivata.
  • È stato risolto il problema relativo alle immagini JPEG acquisite di grandi dimensioni sui dispositivi della serie Samsung S7 (SM-G930T, SM-G930V). Le immagini JPEG acquisite contengono dati di spaziatura interna di 0 ridondanti nel segmento di dati compresso JFIF. Le immagini acquisite avranno dimensioni dei file elevate. Questi dati di spaziatura di zeri ridondanti verranno rimossi per fare in modo che le immagini acquisite abbiano dimensioni normali dei file immagine. (I407b0, b/288828159)
  • È stato risolto il problema dell'immagine JPEG acquisita di grandi dimensioni sui dispositivi delle serie Samsung S22 (SM-S901B, SM-S901B/DS) e S22+ (SM-S906B). Le immagini JPEG acquisite contengono dati di spaziatura di zeri ridondanti nel segmento di dati compressi JFIF. Le immagini acquisite hanno dimensioni del file elevate, circa 13 MB, sul dispositivo S22 SM-S901B/DS. I dati di spaziatura interna degli 0 ridondanti verranno rimossi per fare in modo che le immagini acquisite abbiano dimensioni normali del file immagine. (I73be9, b/288828159)
  • È stato risolto il problema dell'immagine JPEG acquisita di grandi dimensioni sui dispositivi Samsung A5, A52, A70 e A72. Le immagini JPEG acquisite contengono dati di spaziatura di zeri ridondanti nel segmento di dati compressi JFIF. Le immagini acquisite avranno dimensioni estremamente elevate (ad es. circa 32 MB o addirittura 96 MB). Questi dati di spaziatura di zeri ridondanti verranno rimossi per fare in modo che le immagini acquisite abbiano dimensioni normali dei file immagine. (I97c4d, b/288828159)
  • È stato corretto l'arresto anomalo nativo durante lo scatto di foto con le Estensioni attivate (I698f5)

Versione 1.3.0-beta02

26 luglio 2023

androidx.camera:camera-*:1.3.0-beta02 viene rilasciato. La versione 1.3.0-beta02 contiene questi commit.

Correzioni di bug

  • Utilizzare la torcia come flash per le varianti di Pixel 4 e 5 per migliorare la qualità delle foto in condizioni di scarsa illuminazione (I56ff5, b/280221967)
  • È stato risolto il problema relativo alle immagini JPEG acquisite di grandi dimensioni sui dispositivi della serie Samsung A5 (2017). Le immagini JPEG acquisite contengono dati di spaziatura di zeri ridondanti nel segmento di dati compressi JFIF. Le immagini acquisite hanno una dimensione file di circa 32 MB. I dati di spaziatura interna degli 0 ridondanti verranno rimossi per fare in modo che le immagini acquisite abbiano dimensioni normali del file immagine. (I29837, b/288828159)
  • È stato risolto il problema che non consentiva l'attivazione corretta dei nuovi tentativi in caso di errore di acquisizione nei dispositivi problematici menzionati in CaptureFailedRetryQuirk. (I7b589)

Versione 1.3.0-beta01

21 giu 2023

androidx.camera:camera-*:1.3.0-beta01 viene rilasciato. La versione 1.3.0-beta01 contiene questi commit.

Modifiche alle API

  • Il nome della funzione ResolutionSelector.Builder#setHighResolutionEnabledFlag(int) è stato rinominato in setAllowedResolutionMode e le costanti ResolutionSelector#HIGH_RESOLUTION_FLAG_OFF/ON in PREFER_CAPTURE_RATE_OVER_HIGHER_RESOLUTION/PREFER_HIGHER_RESOLUTION_OVER_CAPTURE_RATE. (If84e8)
  • Rimosse le API deprecate ImageAnalysis.setTargetRotationDegrees(int), ImageCapture.setTargetRotationDegrees(int) e VideoCapture.setTargetRotationDegrees(int). (Id8e77)
  • La classe DynamicRange rappresenta la gamma dinamica delle immagini. Questo può essere utilizzato per selezionare i formati High Dynamic Range come output di VideoCapture fino a VideoCapture.Builder#setDynamicRange(). (Ib0377)
  • È stata aggiunta un'API isImageAnalysisSupported a ExtensionsManager che consente alle app di determinare se è possibile associare un caso d'uso ImageAnalysis insieme a Anteprima e ImageCapture quando le Estensioni sono abilitate. (I1bc63).
  • La nuova classe VideoCapabilities ottenuta da Recorder può essere utilizzata per eseguire query sulle gamme dinamiche e sulle qualità supportate per la registrazione video sul dispositivo. I metodi getSupportedQualities() e isQualitySupported() di QualitySelector sono stati deprecati. Usa invece i metodi getSupportedQualities() e isQualitySupported() di VideoCapabilities. (I04014)
  • CameraController#setVideoCaptureTargetQuality() viene rinominato in setVideoCaptureQualitySelector e accetta l'argomento QualitySelector, che offre maggiore flessibilità per la configurazione della qualità video. CameraController#getVideoCaptureTargetQuality() viene modificato in getVideoCaptureQualitySelector di conseguenza. (I520ed)
  • È stata rimossa l'annotazione sperimentale per le funzionalità video. Le funzionalità video sono ora stabili. (I1a113)

Correzioni di bug

  • Usa la torcia come flash sui modelli Samsung SM-A320 per migliorare la velocità e la qualità dell'immagine acquisita in condizioni di scarsa illuminazione. (I6a022, b/286190938)
  • Aggiungi il supporto del formato ImageFormat.JPEG per ImageProxy.toBitmap(). Se non è possibile decodificare l'array di byte JPEG, verrà generato un UnsupportedOperationException. (I81958, b/282057603)

Versione 1.3.0-alpha07

24 maggio 2023

Viene rilasciato androidx.camera:camera-*:1.3.0-alpha07. La versione 1.3.0-alpha07 contiene questi commit.

Nuove funzionalità

  • La nuova API VideoCapture.Builder# setTargetFrameRate(Range) consente di acquisire le registrazioni video con altre frequenze fotogrammi oltre a quella predefinita del dispositivo. È possibile eseguire query sulle frequenze fotogrammi disponibili per le registrazioni tramite la nuova API CameraInfo#getSupportedFrameRates().

Modifiche all'API

  • Le costanti ResolutionSelector#HIGH_RESOLUTION_FLAG_OFF/ON sono state rinominate in ALLOWED_RESOLUTIONS_NORMAL/SLOW e il nome della funzione del generatore setHighResolutionEnabledFlag è stato rinominato in setAllowedResolutionMode. (Iae817).
  • CameraInfo#getSupportedFrameRateRanges() ora restituisce un Set anziché un List per rappresentare meglio che gli intervalli non sono ordinati. (I02f43)
  • Aggiungi un listener di errore a CameraEffect per gestire gli errori non recuperabili (Ice471)
  • Aggiungi il costruttore pubblico in ResolutionInfo per migliorare la testabilità (If6d1c)
  • È stata fornita un'API UseCase.snapToSurfaceRotation(int) per sostituire l'utilizzo di setTargetRotationDegrees e ritirare le API ImageAnalysis.setTargetRotationDegrees(int), ImageCapture.setTargetRotationDegrees(int) e VideoCapture.setTargetRotationDegrees(int). (Ia9010)
  • Sono state aggiunte le nuove API Preview#getTargetFrameRate e Preview.Builder#setTargetFrameRate per poter impostare e recuperare la frequenza fotogrammi target per il caso d'uso Anteprima (If4f22)
  • VideoRecordEvent.Finalize ora verrà completato con il codice di errore ERROR_RECORDING_GARBAGE_COLLECTED quando l'oggetto Recording viene interrotto a causa della raccolta dei rifiuti. (Iba974)

Correzioni di bug

  • È stato corretto NullPointerException quando le dimensioni dell'output memorizzate nella cache in StreamConfigurationMapCompat sono null. (Idf124, b/282025204)
  • È stato risolto il problema per cui Preview.setSurfaceProvider(null) non metteva in pausa l'anteprima nelle estensioni (Ia903e)
  • È stato risolto un problema per cui ConcurrentModificationException viene generato durante l'apertura della fotocamera quando VideoCapture è associato. (Ic8ac4)

Versione 1.3.0-alpha06

19 aprile 2023

androidx.camera:camera-*:1.3.0-alpha06 viene rilasciato. La versione 1.3.0-alpha06 contiene questi commit.

Nuove funzionalità

  • La fotocamera simultanea è una nuova funzionalità introdotta da Android 11, che supporta lo streaming simultaneo di dispositivi con videocamera. Ad esempio, consente di attivare contemporaneamente le fotocamere anteriore e posteriore su un dispositivo. Al momento CameraX supporta solo due fotocamere contemporaneamente, il che consente di utilizzare due fotocamere contemporaneamente, con al massimo due {@link UseCase} associati a ciascuna. La risoluzione massima è 720p o 1440p. Per maggiori dettagli, vedi CameraManager#getConcurrentCameraIds().
  • Ti presentiamo la nuova API ResolutionSelector, che include le seguenti funzionalità:
    • Le applicazioni possono specificare strategie di proporzioni e risoluzione per selezionare quella più adatta alle loro esigenze.
    • Tutti i parametri di dimensioni e proporzioni sono espressi nelle coordinate del sensore del dispositivo della fotocamera.
    • Le applicazioni possono implementare un filtro di risoluzione personalizzato per disporre le dimensioni supportate nell'ordine desiderato.
    • Le applicazioni possono anche attivare l'acquisizione ad alta risoluzione per ottenere immagini con una risoluzione più elevata. Tieni presente, però, che l'utilizzo di una risoluzione elevata potrebbe comportare tempi di acquisizione più lunghi.
    • Aggiunte VideoCapture API di mirroring. I video registrati da VideoCapture non vengono sottoposti a mirroring per impostazione predefinita. Tuttavia, per impostazione predefinita l'anteprima della fotocamera viene speculare sulla fotocamera anteriore. Le VideoCapture API di mirroring consentono di allinearsi all'anteprima della fotocamera quando si utilizza la fotocamera anteriore. Esistono tre MirrorMode, OFF, ON e ON_FRONT_ONLY. Per allinearsi all'anteprima della fotocamera, è consigliabile utilizzare ON_FRONT_ONLY, il che significa che il mirroring non è attivo per la fotocamera posteriore, ma è attivo per la fotocamera anteriore.

Modifiche alle API

  • È stata esposta la nuova API ResolutionSelector. Le applicazioni possono specificare strategie di proporzioni e risoluzione con regole di riserva o un filtro di risoluzione personalizzato per ottenere i risultati desiderati. Le applicazioni possono specificare un flag per attivare l'acquisizione ad alta risoluzione. In questo modo, CameraX potrà selezionare risoluzioni più elevate quando scatti foto o registri video. Tuttavia, tieni presente che se utilizzi un'alta risoluzione i tempi di acquisizione potrebbero essere più lenti. (Ibed95)
  • Ora è possibile eseguire query sugli intervalli FPS supportati dall'algoritmo AE tramite CameraInfo#getSupportedFrameRateRanges(). (Iaa67f)
  • Unifica i nomi di tutti i metodi di frequenza fotogrammi utilizzando "FrameRate". Correggi l'errore javadoc in VideoCapture#getTargetFrameRate() (I83304)
  • È stata ritirata l'API legacy setTargetAspectRatio e setTargetResolution. Utilizza invece la nuova API ResolutionSelector. (I542c3)
  • Sono state aggiunte API pubbliche per la doppia fotocamera simultanea, tra cui
    1. List<List<CameraInfo>> getAvailableConcurrentCameraInfos()
    2. ConcurrentCamera bindToLifecycle(@NonNull ConcurrentCameraConfig concurrentCameraConfig)
    3. boolean isConcurrentCameraModeOn() e ConcurrentCameraConfig, SingleCameraConfig e ConcurrentCamera (Iab1c1)
  • Imposta ImageProcessor.Response#getOutputImage su NonNull (Ib9c60)
  • Sono state aggiunte VideoCapture API di mirroring, tra cui VideoCapture.Builder.setMirrorMode(int) e VideoCapture.getMirrorMode(). Le API sono utili per le applicazioni che richiedono che la registrazione video sia coerente con il comportamento comune dell'anteprima della fotocamera, ovvero che l'anteprima della fotocamera posteriore non sia speculare, ma che l'anteprima della fotocamera anteriore lo sia. (I713b6, b/194634656)
  • Aggiungi l'API setTargetFrameRate() nell'API VideoCapture.Builder e l'API getTargetFramerate() in VideoCapture (I109d4)
  • Fai in modo che SurfaceOutput estenda Closable e nasconda il costruttore pubblico di SurfaceOutput.Event. (I60ea8)
  • È stato aggiunto Recording.mute per attivare o disattivare dinamicamente l'audio di una registrazione in fase di elaborazione. RecordingStats conterrà AudioStats.AUDIO_STATE_MUTED quando la registrazione in fase di elaborazione viene disattivata esplicitamente. (Ie17fc)
  • Il parametro #setEffects() è stato impostato su un valore non nullo. Aggiungi un'API #clearEffects() per eliminare gli effetti. L'app dovrebbe chiamare #clearEffects() per rimuovere gli effetti. (I4b4d9)
  • Aggiungi un secondo costruttore per ViewfinderSurfaceRequest.Builder che accetti un builder per il costruttore di copia (I621a7)

Correzioni di bug

  • È stato risolto il problema per cui le app che richiamavano l'API Extensions potevano arrestarsi in modo anomalo quando si chiudeva la fotocamera (Ib27e5)
  • È stato risolto un problema per cui VideoCapture non poteva funzionare con la fotocamera anteriore su alcuni dispositivi. Ad esempio, su Samsung Galaxy S23 e Xiaomi 2107113SG. (Ibec7e, b/270656244)
  • È stato risolto il problema per cui la fotocamera non riusciva sempre a scattare foto utilizzando File nella cartella pubblica dello spazio di archiviazione esterno su Android 10 e versioni successive. Tieni presente che in Android 10, scattare foto utilizzando File nella cartella pubblica dell'unità di archiviazione esterna richiede anche l'impostazione di requestLegacyExternalStorage su true nel tag dell'applicazione. (I11b2c)
  • È stato corretto un arresto anomalo di RejectedExecutionException in DefaultSurfaceProcessor. L'arresto anomalo potrebbe verificarsi quando VideoCapture è associato e l'attività è in pausa. (Idb46a, b/273713906)

Versione 1.3.0-alpha05

22 marzo 2023

androidx.camera:camera-*:1.3.0-alpha05 viene rilasciato. La versione 1.3.0-alpha05 contiene questi commit.

Modifiche alle API

  • Sono state aggiunte VideoCapture API di rotazione, tra cui VideoCapture.Builder.setTargetRotation(int), VideoCapture.setTargetRotation(int), VideoCapture.setTargetRotationDegrees(int) e VideoCapture.getTargetRotation(). Le API sono utili per le applicazioni che bloccano l'orientamento del dispositivo. Vengono aggiunti anche ImageCapture.setTargetRotationDegrees(int) e ImageAnalysis.setTargetRotationDegrees(int). (Id3ffe, b/205242781)
  • Consenti VIDEO_CAPTURE e PREVIEW|VIDEO_CAPTURE come target degli effetti. Gli effetti che hanno come target VIDEO_CAPTURE verranno applicati all'UseCase VideoCapture; gli effetti che hanno come target PREVIEW|VIDEO_CAPTURE verranno applicati a uno stream condiviso prima di essere copiati negli stream Anteprima e VideoCapture. (Iee6f3)

Correzioni di bug

  • In Fotocamera 1.2.2: è stato risolto il problema per cui le Estensioni CameraX non funzionano correttamente quando ProGuard è attivato su alcuni dispositivi come Pixel (I90aa2)
  • È stato corretto un bug PreviewView che causava la mancata gestione dell'orientamento dello schermo da parte dell'app. L'anteprima potrebbe risultare distorta al momento della rotazione. Questo avviene solo su alcuni dispositivi. Può essere riprodotto su Pixel 4a, Pixel 5 e Pixel 6a. (I14340, b/223488673)

Versione 1.3.0-alpha04

22 febbraio 2023

Viene rilasciato androidx.camera:camera-*:1.3.0-alpha04. La versione 1.3.0-alpha04 contiene questi commit.

Nuove funzionalità

Una nuova funzionalità per supportare combinazioni di Surface non supportate in precedenza condividendo uno stream con più casi d'uso.

  • In precedenza, quando si associava "Anteprima, Video Capture, Analisi dell'immagine" al livello hardware della videocamera FULL e inferiore oppure all'associazione "Anteprima, Video Capture, Image Capture" al livello hardware LEGACY, CameraX genera IllegalArgumentException.
  • Il nuovo comportamento prevede che le associazioni funzionino senza generare eccezioni. CameraX utilizza invece OpenGL per copiare uno stream condiviso sia in Anteprima che in VideoCapture.
  • A causa del costo della copia in buffer, l'app potrebbe registrare un aumento della latenza e del consumo di energia.

Modifiche all'API

  • Aggiungi l'API per convertire ImageProxy in Bitmap. I formati supportati per ImageProxy sono ImageFormat.YUV_420_888 e PixelFormat.RGBA_8888. Se il formato non è valido, verrà generato IllegalArgumentException. (Ic7110)
  • Aggiungi CoroutineCameraViewfinder per supportare la configurazione del mirino usando le funzioni di sospensione in Kotlin. (I657bc)
  • Aggiungi un nuovo costruttore pubblico per ViewfinderSurfaceRequest. Offre la flessibilità necessaria quando l'utente non può fornire CameraCharacteristics. (Ie6549)

Correzioni di bug

  • È stato corretto l'arresto anomalo di Estensioni che si verifica su alcuni dispositivi Samsung quando l'app viene messa in pausa/ripristinata troppo rapidamente (Iaca26)

Versione 1.3.0-alpha03

25 gennaio 2023

androidx.camera:camera-*:1.3.0-alpha03 viene rilasciato. La versione 1.3.0-alpha03 contiene questi commit.

Modifiche alle API

  • È stato aggiunto l'elemento CameraInfo.getIntrinsicZoomRatio per fornire informazioni sull'angolo di visione rispetto alla videocamera predefinita. (Ib300c)
  • È stato aggiunto CameraInfo.getLensFacing per fornire informazioni sulla posizione dell'obiettivo. CameraSelector#LENS_FACING_EXTERNAL aggiunta come funzionalità sperimentale per la selezione di fotocamere esterne. (Icaf3e)
  • Aggiungi #setEffect() a CameraController per aggiungere effetti all'output della fotocamera. (I1d21f)
  • Aggiungi il metodo invalidate() a SurfaceRequest. Il fornitore della piattaforma può comunicare che la piattaforma fornita in precedenza non è più valida. (Idc649)
  • Aggiungi un'API ImageProcessor. Questa interfaccia è progettata per iniettare effetti di post-elaborazione nella pipeline ImageCapture. (I575c6)
  • È stata aggiunta l'API Recorder.Builder.setAspectRatio(), che può essere combinata con QualitySelector per supportare più risoluzioni video. (I8a082)
  • È stato aggiunto Recorder.Builder#setTargetVideoEncodingBitRate per impostare la codifica video target BitRate e Recorder#getTargetVideoEncodingBitRate per ottenere la velocità in bit della codifica video target. (I5984d)

Correzioni di bug

  • È stato corretto l'errore ImageCapture quando non è presente un'unità flash e la modalità flash è attiva. (I9e8b4, b/263391112)
  • È stato risolto il problema di danneggiamento delle immagini JPEG in caso di scrittura dei dati sulla posizione Exif su alcuni dispositivi Samsung con Android 12. (Ib7086, b/263747161, b/263289024)
  • Quando imposti torcia/zoom prima che l'inizializzazione della videocamera inizi, ad esempio chiamando CameraController#enableTorch, l'azione in attesa viene memorizzata nella cache e inviata una volta completata l'inizializzazione. (I11e92, b/264157663)

Versione 1.3.0-alpha02

7 dicembre 2022

androidx.camera:camera-*:1.3.0-alpha02 viene rilasciato. La versione 1.3.0-alpha02 contiene questi commit.

Modifiche all'API

  • aggiungere una nuova API per applicare l'effetto di post-elaborazione all'output di anteprima. (Ic17d5)
  • OutputOptions.getDurationLimit è stato rinominato in OutputOptions.getDurationLimitMillis e OutputOptions.setDurationLimit in OutputOptions.setDurationLimitMillis. (I91f0c)
  • Aggiungi la classe AudioConfig per gestire l'impostazione relativa all'audio durante la registrazione del video. L'annotazione @RequiresPermission viene spostata dalle funzioni startRecording a AudioConfig per evitare richieste di autorizzazione non necessarie nei casi in cui l'audio non è necessario. (I28755)
  • Rimuovi le classi Metadata, OnVideoSavedCallback, OutputFileOptions e OutputFileResults che non vengono più utilizzate dopo l'applicazione della nuova API di acquisizione video. (I38cd8)
  • Applica la nuova API di acquisizione video. I metodi getVideoCaptureTargetSize e setVideoCaptureTargetSize vengono sostituiti rispettivamente con i metodi getVideoCaptureTargetQuality e setVideoCaptureTargetQuality, poiché setTargetResolution non è più supportato. (I2a1d5)

Correzioni di bug

  • Rimuovi l'API core.VideoCapture obsoleta. (I531e0)
  • È stato risolto il problema per cui il callback onError non viene chiamato quando si scattano foto senza l'autorizzazione per lo spazio di archiviazione (I936db, b/244807669)
  • Migliorare la qualità e l'affidabilità delle estensioni della videocamera. Le estensioni della fotocamera sono disattivate sui dispositivi Motorola che utilizzano Camera Extensions v1.1.0 e versioni precedenti a causa di problemi con il supporto di Bokeh e il mancato ripristino dell'acquisizione di immagini e dell'anteprima. (Id3ce3)
  • È stato corretto l'arresto anomalo nativo quando il ritaglio dei video tramite ViewPort è abilitato sui dispositivi precedenti. (I16b8a, b/251357665)

Versione 1.3.0-alpha01

9 novembre 2022

androidx.camera:camera-*:1.3.0-alpha01 viene rilasciato. La versione 1.3.0-alpha01 contiene questi commit.

Nuove funzionalità

  • Camera-viewfinder è stato pubblicato ufficialmente. Camera-viewfinder fornisce un widget del mirino di base che può mostrare il feed della videocamera per la videocamera 2. Per un esempio, consulta il codice campione.

Modifiche all'API

  • È stato aggiunto OutputOptions.setDurationLimit per consentire l'impostazione del limite di durata dei video. La registrazione verrà completata automaticamente quando viene superato il limite di durata specificato. (I902a0)
  • Aggiungi lo stato di errore audio della registrazione video AudioStats.AUDIO_STATE_SOURCE_ERROR. Viene inviato quando la configurazione dell'origine audio non riesce o si verifica un errore. (I37410)

Correzioni di bug

  • Aggiunta di una funzionalità per consentire ad alcuni dispositivi problematici di riprovare a acquisire una volta in caso di errori di acquisizione. (Id4795)
  • Risolto il problema di schermo nero relativo all'implementazione di PreviewView SurfaceView su ViewPager2. Nell'ambito della correzione, PreviewView riutilizza il proprio SurfaceView se la risoluzione richiesta non viene modificata. (Ib3f27)
  • Supporta il ritaglio dei video (funzionalità WYSIWYG) quando viene utilizzata l'API ViewPort o CameraController. (Ifbba8, b/201085351)
  • Il video acquisito con la fotocamera anteriore non riesce a essere registrato su Huawei P40 lite. (I87c57, b/250807400)

Versione 1.2

Versione 1.2.3

24 maggio 2023

androidx.camera:camera-*:1.2.3 viene rilasciato. La versione 1.2.3 contiene questi commit.

Correzioni di bug

  • È stato risolto un problema per cui VideoCapture non poteva funzionare con la fotocamera anteriore su alcuni dispositivi. Ad esempio, su Samsung Galaxy S23 e Xiaomi 2107113SG. (Ibec7e, b/270656244)

Versione 1.2.2

22 marzo 2023

androidx.camera:camera-*:1.2.2 viene rilasciato. La versione 1.2.2 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema relativo al mancato funzionamento delle Estensioni CameraX quando ProGuard è attivo su alcuni dispositivi come Pixel (I90aa2)

Versione 1.2.1

25 gennaio 2023

androidx.camera:camera-*:1.2.1 viene rilasciato. La versione 1.2.1 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema di danneggiamento delle immagini JPEG se si scrivono i dati sulla posizione Exif su alcuni dispositivi Samsung con Android 12. (b/263289024)

Versione 1.2.0

7 dicembre 2022

androidx.camera:camera-*:1.2.0 viene rilasciato. La versione 1.2.0 contiene questi commit.

Modifiche importanti dalla versione 1.1.0

  • Nuova libreria camera-mlkit-vision. Integra facilmente CameraX con molte funzionalità di MLKit, tra cui scansione di codici a barre, rilevamento di volti, rilevamento di testo e così via. Sono state aggiunte MLKitAnalyzer come nuove API.
  • Nuova API sperimentale Zero-Shutter Lag. Ottimizza la pipeline di acquisizione per avere una latenza migliore mantenendo una buona qualità dell'immagine. Se la modalità di acquisizione è impostata su CAPTURE_MODE_ZERO_SHUTTER_LAG, la latenza tra il clic con il pulsante di scatto e lo scatto della foto dovrebbe essere ridotta al minimo, rispetto ad altre modalità di acquisizione. Sui dispositivi che non supportano ZERO_SHUTTER_LAG, verrà eseguito il fallback a CAPTURE_MODE_MINIMIZE_LATENCY.
  • Ignora android.camera.core.VideoCapture.
  • È stata aggiunta setStreamUseCase() come API Camera2Interop pubblica.
  • È stato aggiunto il requisito del livello API per setOutputImageRotationEnabled.
  • ImageAnalysis.Analyzer#getTargetResolutionOverride() rinominato in ImageAnalysis.Analyzer#getDefaultTargetResolution().
  • È stata aggiunta un'API per impostare i metadati della posizione sul video salvato.
  • È stato risolto il problema di frame rate basso quando si utilizzano i casi d'uso VideoCapture e Anteprima con proporzioni 16:9
  • È stato risolto il problema dell'anteprima nera che si verifica quando l'estensione BOKEH è attivata su alcuni dispositivi Samsung e l'utente cambia la fotocamera.
  • È stato risolto il problema di estensione del problema di Samsung J7 Prime (SM-G610M) e J7 (SM-J710MN) Preview/VideoCapture sui dispositivi di livello API 27.
  • È stata disattivata la soluzione alternativa per capovolgere orizzontalmente la regione AF delle fotocamere anteriori su Samsung Android T poiché il problema è stato risolto

Versione 1.2.0-rc01

24 ottobre 2022

androidx.camera:camera-*:1.2.0-rc01 viene rilasciato. La versione 1.2.0-rc01 contiene questi commit.

Modifiche all'API

  • Aggiungi l'API setStreamUseCase per OutputConfiguration. L'utente può specificare il caso d'uso di streaming per la sessione di streaming, sostituendo le logiche interne di CameraX per scegliere il caso d'uso di streaming in modo da ottimizzare in base alle proprie esigenze. (Ib1a95)

Correzioni di bug

  • È stato corretto il problema di allungamento Preview/VideoCapture di Samsung J7 Prime (SM-G610M) e J7 (SM-J710MN) sui dispositivi con livello API 27. La risoluzione 1920 x 1080 causa lo stretching delle immagini Preview/VideoCapture. È stata aggiunta una soluzione alternativa per non selezionare la risoluzione 1920 x 1080 per l'anteprima o VideoCapture per evitare il problema dell'immagine allungata. (I0e04e)
  • È stato corretto il frame rate basso quando si utilizzano i casi d'uso VideoCapture e Anteprima con proporzioni 16:9 su alcuni dispositivi Huawei. (If8c88, b/223643510)
  • È stato corretto l'errore di apertura della videocamera quando SurfaceProvider di Anteprima non è impostato. Nell'ambito della correzione, l'anteprima senza SurfaceProvider impostato non verrà configurata nella sessione di acquisizione con la fotocamera. (I99681)

Versione 1.2.0-beta02

21 settembre 2022

Viene rilasciato androidx.camera:camera-*:1.2.0-beta02. La versione 1.2.0-beta02 contiene questi commit.

Modifiche all'API

  • Aggiungi il requisito del livello API per setOutputImageRotationEnabled (I26e3e, b/240993561)

Correzioni di bug

  • Poiché il problema è stato risolto, è stata disattivata la soluzione alternativa per capovolgere orizzontalmente la regione AF delle fotocamere anteriori su Samsung Android T. (I05f69)
  • È stato risolto il problema di anteprima nera che si verifica quando l'estensione BOKEH è attivata su alcuni dispositivi Samsung e l'utente cambia fotocamera. (If6168)

Versione 1.2.0-beta01

24 agosto 2022

androidx.camera:camera-*:1.2.0-beta01 viene rilasciato. La versione 1.2.0-beta01 contiene questi commit.

Nuove funzionalità

  • Nuova raccolta camera-mlkit-vision. Integra facilmente CameraX con molte funzionalità di MLKit, tra cui scansione di codici a barre, rilevamento di volti, rilevamento di testo e così via. Trova il codice di esempio qui.
  • Nuova API Zero-Shutter Lag sperimentale. Ottimizza la pipeline di acquisizione per avere una latenza migliore mantenendo una buona qualità dell'immagine. Quando la modalità di acquisizione è impostata su CAPTURE_MODE_ZERO_SHUTTER_LAG, la latenza tra il clic sul pulsante di scatto e lo scatto della foto dovrebbe essere ridotta al minimo, rispetto ad altre modalità di acquisizione. Sui dispositivi che non supportano ZERO_SHUTTER_LAG, verrà usato il fallback CAPTURE_MODE_MINIMIZE_LATENCY.
  • ImageAnalysis.Analyzer e MLKitAnalyzer resi come API ufficiali.
  • API esposta per l'impostazione dei metadati della posizione nel video salvato.
  • Rinomina ImageAnalysis.Analyzer#getTargetResolutionOverride() in ImageAnalysis.Analyzer#getDefaultTargetResolution().

Correzioni di bug

  • È stato risolto il problema di acquisizione delle immagini di Alps k61v1_basic_ref. Le immagini JPEG acquisite da HAL hanno metadati EXIF errati. I metadati Exif non hanno il tag 0xffd9 o 0xffda per consentire a ExifInterface di analizzare correttamente gli attributi. Per aggirare il problema, acquisisci le immagini in formato YUV e poi comprimile in JPEG. (I45abb)

Versione 1.2.0-alpha04

27 luglio 2022

androidx.camera:camera-*:1.2.0-alpha04 viene rilasciato. La versione 1.2.0-alpha04 contiene questi commit.

Modifiche all'API

  • Rinomina ImageAnalysis.Analyzer#getTargetResolutionOverride() in ImageAnalysis.Analyzer#getDefaultTargetResolution(). Il comportamento viene modificato anche in modo che il valore restituito da questo metodo possa essere sostituito dal valore ImageAnalysis#setTargetResolution(). (If1d36)
  • API esposta per l'impostazione dei metadati della posizione nel video salvato. Un oggetto android.location.Location può essere impostato tramite la nuova API androidx.camera.video.OutputOptions.Builder.setLocation(Location). (I313a0, b/204197544)

Correzioni di bug

  • Risolvere il problema di acquisizione di foto con l'anteprima di scollegamento (Ie70b6, b/235119898)
  • È stato corretto un arresto anomalo in Recorder quando si tenta di registrare quando l'origine audio non è disponibile. (I9f652)

Versione 1.2.0-alpha03

29 giugno 2022

androidx.camera:camera-*:1.2.0-alpha03 viene rilasciato. La versione 1.2.0-alpha03 contiene questi commit.

Modifiche alle API

  • È stata rimossa l'annotazione sperimentale per ImageAnalysis.Analyzer e MLKitAnalyzer. (I0ff22)

Correzioni di bug

  • È stato aggiunto il timeout predefinito per l'autofocus di 5000 ms che completa la parte di AF con isFocusSuccessful false se FocusMeteringAction non viene annullato e la parte di AF non è convergente nella durata. (Ibc2e3)
  • Risolvere il problema di acquisizione di foto con l'anteprima di scollegamento (I1d3a2, b/235119898)
  • Abilitata l'implementazione avanzata dell'extender e aggiorna la versione dell'interfaccia delle estensioni di supporto di CameraX alla versione 1.2 (I92256)

Versione 1.2.0-alpha02

1° giugno 2022

androidx.camera:camera-*:1.2.0-alpha02 viene rilasciato. La versione 1.2.0-alpha02 contiene questi commit.

Nuove funzionalità

  • Esponi l'API CameraX Zero-Shutter Lag come sperimentale.

Modifiche all'API

  • Aggiungi la nuova modalità di acquisizione CAPTURE_MODE_ZERO_SHUTTER_LAG in ImageCapture e isZslSupported in CameraInfo per eseguire una query sulla funzionalità del dispositivo. La modalità CAPTURE_MODE_ZERO_SHUTTER_LAG mira a fornire la latenza minima per l'acquisizione istantanea. È implementato in base a un buffer circolare, che memorizza nella cache i risultati di acquisizione intermedi per il successivo rielaborarli quando l'utente preme i pulsanti per scattare foto. Se {@link VideoCapture} è associato o la modalità flash non è OFF o l'estensione OEM è ON, questa modalità verrà disattivata automaticamente. (I9ae74)
  • Aggiungi il metodo ImageAnalysis.getBackgroundExecutor() (Icc945)

Correzioni di bug

  • È stato corretto il metodo ImageCapture takePicture che disattiva la torcia sui dispositivi segnalati. (Ib5eb5, b/228272227)
  • È stato corretto un bug per cui AssertionError non viene gestito durante il recupero della caratteristica CONTROL_ZOOM_RATIO_RANGE.(/Ia248a, b/231701345)

Versione 1.2.0-alpha01

18 maggio 2022

androidx.camera:camera-*:1.2.0-alpha01 viene rilasciato. La versione 1.2.0-alpha01 contiene questi commit.

Nuove funzionalità

  • È stata lanciata la nuova libreria camera-mlkit-vision

Correzioni di bug

  • È stato corretto il problema per cui QualitySelector non riesce a registrare un video UHD quando è attiva una strategia di riserva. Il problema si verifica quando VideoCapture è associato a ImageCapture e Anteprima su un dispositivo con videocamera a livello hardware FULL o superiore. Una strategia di riserva di QualitySelector fa sì che VideoCapture ottenga erroneamente una risoluzione FHD. La risoluzione UHD è effettivamente supportata per questa combinazione di casi d'uso e dovrebbe essere adottata. (I0e788, b/230651237)
  • NullPointerException è stato corretto il giorno ImageCapture.takePicture(). (I92366, b/230454568, b/229766155)
  • Correggi il comportamento della pausa asincrona di androidx.camera.video.Recorder (Ia8ce8)

Camera-Camera2, Camera-Core, Camera-Lifecycle e Camera-Video versione 1.1.0

Versione 1.1.0

29 giugno 2022

androidx.camera:camera-*:1.1.0 viene rilasciato. La versione 1.1.0 contiene questi commit.

Modifiche importanti dalla versione 1.0.0

  • Le librerie Landed View, Extension e Video Capture sono la loro prima versione RC. A partire dalla versione 1.1.0-beta01, tutte le librerie CameraX avranno lo stesso numero di versione. In questo modo, gli sviluppatori potranno tenere traccia delle versioni molto più facilmente e ridurre la complessità delle grandi matrici di compatibilità delle versioni.
  • Sono state introdotte nuove API e funzionalità pubbliche, tra cui:
  • Aggiungi la raccolta video della fotocamera ufficiale per supportare i casi d'uso di acquisizione video.
  • Funzionalità di conversione e rotazione da YUV a RGB (ImageAnalysis.Builder.setOutputImageRotationEnabled e setOutputImageFormat)
  • Supporta la modalità multifinestra consentendo alle applicazioni CameraX di riprendere la fotocamera quando viene interrotta da un'altra app e il fuoco è di nuovo attivo.
  • Garantisce il corretto funzionamento di CameraX nei dispositivi pieghevoli risolvendo alcuni problemi di anteprima.
  • È stata aggiunta un'API CameraState che verrà esposta tramite CameraInfo.
  • È stata aggiunta un'API ProcessCameraProvider.getAvailableCameraInfos() per recuperare direttamente le informazioni sulle videocamere disponibili
  • Formato JPEG di output per ImageCapture#OnImageCapturedCallback quando le estensioni sono attive.
  • È stata aggiunta un'API isFocusMeteringSupported in CameraInfo che consente alle applicazioni di verificare se il FocusMeteringAction specificato è supportato sulla videocamera attuale.
  • È stata esposta l'API getResolutionInfo per fornire le informazioni sulla risoluzione per Anteprima, ImageCapture e ImageAnalysis.
  • È stata aggiunta una nuova API ImageCapture.Builder#setJpegQuality per consentire di modificare la qualità di compressione delle immagini JPEG in uscita quando scatti foto.
  • CameraSelector#filter aggiunto all'API pubblica per filtrare un elenco di CameraInfos in base a un CameraSelector.
  • È stato aggiunto Camera2CameraControl.clearCaptureRequestOptions per cancellare le opzioni di richiesta di acquisizione esistenti.
  • È stata aggiunta un'API sperimentale per l'utilizzo di CameraController con librerie di elaborazione delle immagini esterne, ad esempio MLKit
  • Aggiunta l'API sperimentale CameraInfo#getCameraSelector() che restituisce un CameraSelector univoco alla fotocamera
  • Sono state promosse diverse API sperimentali ad API pubbliche formali
  • L'annotazione @Experimental è stata sostituita con @RequiresOptIn nelle API sperimentali. Per chiamare le API sperimentali, utilizza androidx.annotation.OptIn anziché androidx.annotation.experimental.UseExperimental, che è deprecato.
  • Sono state promosse a API ufficiali le seguenti API sperimentali: CameraXConfig.Builder#setAvailableCamerasLimiter(), CameraXConfig.Builder#setMinimumLoggingLevel(), CameraXconfig.Builder#setSchedulerHandler(), CameraXConfig#getAvailableCamerasLimiter(), CameraXConfig#getMinimumLoggingLevel(), CameraXConfig#getCameraExecutor(), CameraXConfig#getSchedulerHandler(),
  • API @ExperimentalCameraFilter
  • API sperimentali di compensazione dell'esposizione.
  • È stata promossa l'API UseCaseGroup sperimentale per camera-core, camera-lifecycle e camera-video. Sono stati aggiunti ViewPort#getLayoutDirection, ViewPort.Builder#setLayoutDirection e ViewPort.Builder#setScaleType per personalizzare il viewport.
  • È stata promossa la versione ExperimentalUseCaseGroupLifecycle alle API pubbliche formali.
  • Modifiche alle API esistenti
  • Renamed MediaStoreOutputOptions.getCollection per MediaStoreOutputOptions.getCollectionUri.
  • ActiveRecording è stato rinominato "Registrazione" per ridurre il livello di dettaglio.
  • È stata modificata l'API per i creator di QualitySelector in un'API basata su elenco

Correzioni di bug

  • È stato risolto il problema YuvToJpegProcessor EOFException quando è attiva la modalità di estensione e la modalità ImageCapture#CAPTURE_MODE_MAX_QUALITY è impostata.
  • Correzione della configurazione del codec non riuscita a causa della chiusura della registrazione video
  • È stato corretto il problema di allungamento delle proporzioni dell'anteprima/del video durante la registrazione a FHD
  • È stato corretto l'audio/video non sincronizzato dopo la messa in pausa e la ripresa su alcuni dispositivi
  • È stato risolto il problema per cui il flash si attiva durante il tocco per mettere a fuoco (startFocusAndMetering) quando la modalità flash è automatica o always_on in ambienti con scarsa illuminazione.

Versione 1.1.0-rc02

1 giugno 2022

androidx.camera:camera-*:1.1.0-rc02 viene rilasciato. La versione 1.1.0-rc02 contiene questi commit.

Correzioni di bug

  • NullPointerException è stato corretto il giorno ImageCapture.takePicture(). (I92366, b/230454568, b/229766155)
  • È stato corretto un bug per cui AssertionError non viene gestito durante il recupero della caratteristica CONTROL_ZOOM_RATIO_RANGE. (Ia248a, b/231701345)

Versione 1.1.0-rc01

11 maggio 2022

androidx.camera:camera-*:1.1.0-rc01 viene rilasciato. La versione 1.1.0-rc01 contiene questi commit.

Nuove funzionalità

  • Rilacia la prima versione RC per camera-video, camera-view e camera-extension

Correzioni di bug

  • È stato risolto un problema per cui il codec video non veniva rilasciato quando VideoCapture<Recorder> non era vincolato, causando l'interruzione degli utilizzi successivi di VideoCapture<Recorder> durante la registrazione con MediaCodec.CodecException, in particolare sui dispositivi con API 21-22. (Ie7f68)
  • Correggere le immagini acquisite di CameraExtensionsActivity in modo che non vengano eliminate in ImageCaptureTest

Versione 1.1.0-beta03

6 aprile 2022

androidx.camera:camera-*:1.1.0-beta03 viene rilasciato. La versione 1.1.0-beta03 contiene questi commit.

Modifiche all'API

  • Il costruttore CaptureRequestOptions è stato limitato. (I261b6)
  • È stata aggiunta un'API sperimentale per l'utilizzo di CameraController con librerie di elaborazione delle immagini esterne, ad esempio MLKit (I4ea71)

Correzioni di bug

  • È stato risolto il problema per cui l'anteprima si sposta lateralmente in PreviewView quando l'attività non viene riavviata dopo la rotazione dei dispositivi in modalità multi-finestra. (I1ea36, b/223488673)
  • È stato risolto un problema relativo alle finestre multiple: quando lo stato attivo torna all'app, non riesce a riprendere la fotocamera quando (1) un'altra app ad alta priorità apre una fotocamera diversa (2) il dispositivo è Samsung Android 12. (I7e9f2)
  • Soluzione alternativa inclusa per i dispositivi che si arrestano in modo anomalo durante la verifica della disponibilità di Flash. Su questi dispositivi non sarà disponibile la torcia. (If26a3, b/216667482)
  • È stato risolto il problema AbstractMethodError che si verificava quando le app utilizzano estensioni e attivano ProGuard. (I7cbaf, b/222726805)
  • Forza la disattivazione della modalità di estensione bokeh sul dispositivo Motorola razr 5G che causerà un problema con la schermata di anteprima nera. (I35d49)
  • È stato corretto l'audio/video non sincronizzato dopo la messa in pausa e la ripresa su alcuni dispositivi Samsung precedenti all'API 29. (I64622, b/202798609, b/202798572)
  • È stato corretto il problema di audio/video non sincronizzato dopo la messa in pausa e la ripresa su Sony G3125. (I2a1a5, b/202799148)
  • È stato risolto un arresto anomalo quando Registratore ha rilevato un InvalidConfigException. Tuttavia, questa correzione impedisce solo l'arresto anomalo dell'app, ma non risolve la causa di InvalidConfigException. Se non è ancora possibile configurare Recorder, le applicazioni riceveranno una chiamata di ritorno di errore all'avvio della registrazione. (I89c29, b/213617227)

Contributo esterno

  • API :compose:ui:ui-test aggiornata (updateApi) a causa della migrazione di test-coroutines-lib (I3366d)

Versione 1.1.0-beta02

23 febbraio 2022

androidx.camera:camera-*:1.1.0-beta02 viene rilasciato. La versione 1.1.0-beta02 contiene questi commit.

Modifiche alle API

  • Aggiunta la possibilità di specificare l'ID fisico della fotocamera tramite Camera2Interop. (I5aed8)

Correzioni di bug

  • Risolto il problema dell'anteprima estesa su Oppo Find N (I7d004)
  • È stato risolto un problema relativo al Galaxy J7 Prime per cui l'anteprima è distorta. (I4c500)
  • Utilizza una velocità in bit compatibile per trovare il codificatore video. (d969052)

Versione 1.1.0-beta01

26 gennaio 2022

androidx.camera:camera-*:1.1.0-beta01 viene rilasciato. La versione 1.1.0-beta01 contiene questi commit.

Nuove funzionalità

  • A partire dalla versione 1.1.0-beta01, tutte le librerie CameraX avranno lo stesso numero di versione. In questo modo, gli sviluppatori potranno monitorare le versioni molto più facilmente e ridurre la complessità della matrice di compatibilità delle versioni di grandi dimensioni.

Modifiche all'API

  • È stato aggiunto Camera2CameraControl.clearCaptureRequestOptions per cancellare le opzioni di richiesta di acquisizione esistenti. (Ifa07d)

Correzioni di bug

  • È stato corretto l'arresto anomalo durante la registrazione del video su alcuni dispositivi precedenti ad Android O(API 26). (I88fdf, b/212328261)
  • Risolto il problema della regione AF errata quando si utilizza cameraControl#startFocusAndMetering() sulla fotocamera anteriore rivolta verso l'obiettivo nei dispositivi Samsung (Ifbf59, b/210548792)
  • Usare la torcia come flash su Pixel 3a/Pixel 3a XL per migliorare la velocità e la qualità delle immagini acquisite in condizioni di scarsa illuminazione (Ib12b6, b/211474332)
  • Consente alle applicazioni di riprendere la fotocamera quando la fotocamera viene interrotta da un'altra applicazione con priorità più alta nella modalità a più finestre e lo stato attivo torna all'applicazione. Tieni presente che potrebbe esserci un po' di latenza(da 1 a 10 secondi o più) tra le modifiche dell'effetto bokeh e la riapertura della fotocamera a causa di un problema del framework. (I4d092)

Versione 1.1.0-alpha12

15 dicembre 2021

androidx.camera:camera-*:1.1.0-alpha12 viene rilasciato. La versione 1.1.0-alpha12 contiene questi commit.

Modifiche all'API

  • Sono state rimosse le annotazioni @RequiresApi(21) non necessarie dalle classi/interfacce interne. (I8e286, b/204917951)
  • Le costanti di qualità e le costanti della strategia di riserva di QualitySelector sono state modificate in modo da essere rappresentate da oggetti di classe. Ad esempio, QualitySelector.QUALITY_HD viene modificato in Quality.HD e QualitySelector.FALLBACK_STRATEGY_LOWER viene modificato nell'istanza restituita da FallbackStrategy.lowerQualityOrHigherThan(Quality). L'API utilizzata per creare QualitySelector è stata modificata in un'API basata su elenchi. La nuova API QualitySelector.fromOrderedList(List<Quality>) farà riferimento all'ordine dell'elenco di qualità di input anziché all'ordine creato da QualitySelector.Procedure. Il corso QualitySelector.Procedure è stato rimosso. (I43343)
  • PendingRecording.withEventListener() è stato rimosso e il listener di eventi ora deve essere passato a PendingRecording.start(). Questo requisito per i listener di eventi ha lo scopo di incoraggiare la gestione degli errori asincroni segnalati nell'evento VideoRecordEvent.Finalize. (I1e71d).
  • ActiveRecording è stato rinominato in Recording per ridurre la verbosità. (I77ceb)

Correzioni di bug

  • È stato risolto il problema per cui le foto scattate in modalità FLASH_AUTO sono sottoesposte in condizioni di scarsa illuminazione su Pixel 3a e Pixel 3a XL (I13f19, b/205373142)
  • Usa sempre le dimensioni di visualizzazione più recenti per determinare l'anteprima Resolution. (I4a694)
  • Sono state escluse le videocamere che non dispongono di REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE. Le fotocamere con REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE dispongono del set minimo di funzionalità supportate da ogni dispositivo. La videocamera senza REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE potrebbe essere una videocamera che supporta funzionalità speciali e non supporta l'uscita a colori standard. CameraX non può supportare i casi d'uso Preview, ImageCapture, ImageAnalysis o VideoCapture per queste videocamere. Pertanto, queste videocamere devono essere filtrate per evitare un utilizzo non corretto. (Ib8cda)
  • CameraSelector#filter non genera più un IllegalArgumentException quando il set di risultati è vuoto. (I27804)
  • Ora vengono utilizzate strategie di euristica più intelligenti per selezionare le impostazioni del codificatore in base ai profili specificati dall'OEM. (Iaeef0)
  • L'anteprima fissa avrà linee di colore interlacciate dopo l'avvio della registrazione video UHD su Pixel 1. (I833c6, b/205340278)

Versione 1.1.0-alpha11

17 novembre 2021

androidx.camera:camera-*:1.1.0-alpha11 viene rilasciato. La versione 1.1.0-alpha11 contiene questi commit.

Modifiche all'API

  • È stato aggiunto CameraSelector#filter all'API pubblica per filtrare un elenco di CameraInfos in base a un CameraSelector. (I105d0)
  • Aggiungi l'API setOutputImageRotationEnabled per la configurazione di ImageAnalysis. L'utente può attivare la rotazione per il buffer di immagini YUV/RGB. Il grado di rotazione è una rotazione relativa calcolata in base alla rotazione del sensore e alla rotazione del target per mantenere l'immagine in primo piano.

  • Aggiungi l'API setOutputImageTrackingEnabled per la configurazione di ImageAnalysis. L'utente può attivare la rotazione per il buffer di immagini YUV/RGB. Il grado di rotazione è una rotazione relativa calcolata in base alla rotazione del sensore e alla rotazione del target per mantenere l'immagine in primo piano.

    Aggiungi l'API getSensorToBufferTransformMatrix in ImageInfo. La matrice restituita è una mappatura dalle coordinate del sensore alle coordinate del buffer, ovvero dal valore di CameraCharacteristics.SENSOR_INFO_ACTIVE_ARRAY_SIZE a (0, 0, image.getWidth, image.getHeight). La matrice può essere utilizzata per mappare le coordinate da un {UseCase} a un altro. Ad esempio, mappare le coordinate del volto rilevato con ImageAnalysis in Anteprima. (I9ff1e)

  • È stata aggiunta una nuova API ImageCapture.Builder#setJpegQuality per consentire di modificare la qualità di compressione delle immagini JPEG in uscita durante lo scatto. (I8dcf4)

  • È stato rinominato MediaStoreOutputOptions.getCollection in MediaStoreOutputOptions.getCollectionUri. (I16639)

Correzioni di bug

  • È stato risolto il problema per cui il flash si attivava durante il tocco per mettere a fuoco (startFocusAndMetering) quando la modalità flash è automatica o sempre attiva in condizioni di scarsa illuminazione. (Id4c11)
  • È stata disattivata la funzionalità HDR+ su Pixel 2 XL / Pixel 3 XL in modalità MINIMIZZA_LATENCY per ridurre la latenza. (Ib6270, b/203505523)

Contributo esterno

Versione 1.1.0-alpha10

13 ottobre 2021

Viene rilasciato androidx.camera:camera-*:1.1.0-alpha10. La versione 1.1.0-alpha10 contiene questi commit.

Nuove funzionalità

  • È stata rilasciata ufficialmente la prima versione alpha di androidx.camera:camera-video:1.1.0-alpha10 per Video. Esistono diversi problemi noti che verranno risolti nelle release successive.

Modifiche alle API

  • È stata aggiunta l'annotazione @RequiresApi(21) a tutte le classi CameraX ed è stato rimosso il valore minSdkVersion da AndroidManifest.xml. In questo modo, camera-core potrà essere facilmente integrato nelle applicazioni con un minSdkVersion inferiore a 21, ma che vogliono utilizzare in modo condizionale i percorsi di codice che si basano sull'API 21 e versioni successive. Per qualsiasi applicazione con minSdkVersion 21 o superiore, questa modifica non richiede alcuna azione. (Ie7f2e, b/200599470)

Correzioni di bug

  • Lancia un'eccezione InitializationException per consentire all'app di gestire in modo elegante l'errore AssertionError che si è verificato durante la creazione di CameraCharacteristics. (Ibec79)

Versione 1.1.0-alpha09

29 settembre 2021

androidx.camera:camera-camera2:1.1.0-alpha09, androidx.camera:camera-core:1.1.0-alpha09 e androidx.camera:camera-lifecycle:1.1.0-alpha09 vengono rilasciati. La versione 1.1.0-alpha09 contiene questi commit.

Modifiche all'API

  • L'annotazione ExperimentalUseCaseGroup è stata rimossa ora che le API non sono più sperimentali. (I01ef5)

Correzioni di bug

  • Risolvi il problema per cui le foto scattate erano sfocate in modalità MAXIMIZE_QUALITY. (I173a9, b/193823892)
  • È stato risolto un problema del Samsung Galaxy J5 per cui la fotocamera si blocca dopo aver scattato foto con il flash attivo/automatico in ambienti bui (I3aab9)
  • Quando è necessario il ritaglio per ImageCapture, l'immagine ritagliata in uscita viene compressa con il livello di qualità JPEG specificato in base alla modalità di acquisizione impostata. Se la modalità di acquisizione è CAPTURE_MODE_MINIMIZE_LATENCY, la qualità di compressione JPEG sarà 95. Se la modalità di acquisizione è CAPTURE_MODE_MAXIMIZE_QUALITY, la qualità di compressione JPEG sarà 100. (Ieb37c, b/142856426)

Versione 1.1.0-alpha08

18 agosto 2021

androidx.camera:camera-camera2:1.1.0-alpha08, androidx.camera:camera-core:1.1.0-alpha08 e androidx.camera:camera-lifecycle:1.1.0-alpha08 vengono rilasciati. La versione 1.1.0-alpha08 contiene questi commit.

Nuove funzionalità

  • Aggiungi l'API setOutputImageFormat per la configurazione dell'analisi delle immagini. L'utente può selezionare ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888 o ImageAnalysis.OUTPUT_IMAGE_FORMAT_RGBA_8888. Per impostazione predefinita, sarà selezionato ImageAnalysis.OUTPUT_IMAGE_FORMAT_YUV_420_888. (I7902d)

Modifiche all'API

  • L'annotazione ExperimentalUseCaseGroupLifecycle viene rimossa ora che le API non sono più sperimentali. (I17b85)

Correzioni di bug

  • È stato corretto il problema relativo alla luminosità eccessiva della schermata di anteprima su Huawei P20 Lite. Questo problema si verifica solo quando vengono utilizzate determinate risoluzioni di anteprima speciali insieme a un valore di zoom in elevato. (Idefce, b/192129158)
  • È stato risolto un problema per cui il flash non funziona su alcuni dispositivi quando si imposta la modalità flash su FLASH_MODE_ON poco dopo aver scattato foto. (Ieb49b)
  • È stato risolto il problema per cui Anteprima si arrestava per un po' di tempo quando si scattavano foto se VideoCapture, ImageCapture e Anteprima erano associati. (I56197, b/193864120)
  • Consente a ImageAnalysis di selezionare una risoluzione superiore a 1080p. Un dispositivo di livello LIMITATO può supportare una risoluzione di dimensione RECORD per ImageAnalysis quando è associato a Preview e Image Capture. Lo svantaggio è che la risoluzione selezionata per l'acquisizione di immagini deve essere anche una risoluzione di dimensione del RECORD. Per selezionare correttamente la risoluzione delle dimensioni RECORD per ImageAnalysis, è necessario impostare una risoluzione target della dimensione RECORD sia su Image Capture che su ImageAnalysis. Ciò indica che l'applicazione comprende chiaramente il compromesso e preferisce che ImageAnalysis abbia una risoluzione maggiore anziché che ImageCapture abbia una risoluzione MASSIMA. Per le definizioni delle dimensioni RECORD e MASSIME e per ulteriori dettagli, visita la pagina https://developer.android.com/reference/android/hardware/camera2/CameraDevice#regular-capture. Le dimensioni del RECORD si riferiscono alla risoluzione di registrazione massima supportata dalla fotocamera, come determinata da CamcorderProfile. La dimensione MASSIMA si riferisce alla risoluzione di output massima del dispositivo della fotocamera per quel formato o target da StreamConfigurationMap.getOutputSizes(int). (I1ee97, b/192911449)
  • Aggiungi le informazioni Exif all'immagine acquisita. (I01ff0, b/193342619)
  • In ImageCapture, restituisce l'URI dell'immagine salvata se la posizione di salvataggio è File. (Ib5b49, b/149241379)
  • È stato risolto il problema a causa del quale le immagini acquisite con flash erano scure su molti dispositivi. (I4e510)

Versione 1.1.0-alpha07

21 luglio 2021

androidx.camera:camera-camera2:1.1.0-alpha07, androidx.camera:camera-core:1.1.0-alpha07 e androidx.camera:camera-lifecycle:1.1.0-alpha07 vengono rilasciati. La versione 1.1.0-alpha07 contiene questi commit.

Correzioni di bug

  • Risolto un problema del Samsung Galaxy Note 5 che causava il blocco della fotocamera dopo aver scattato foto con il flash attivato/automatico in un ambiente buio (If6871)
  • È stato risolto il problema YuvToJpegProcessor EOFException quando la modalità di estensione è attivata e la modalità ImageCapture#CAPTURE_MODE_MAX_QUALITY è impostata. (I538bd, b/192017012)

Versione 1.1.0-alpha06

30 giugno 2021

androidx.camera:camera-camera2:1.1.0-alpha06, androidx.camera:camera-core:1.1.0-alpha06 e androidx.camera:camera-lifecycle:1.1.0-alpha06 vengono rilasciati. La versione 1.1.0-alpha06 contiene questi commit.

Modifiche all'API

  • Promuovi le API sperimentali di compensazione dell'esposizione per camera-core (I08ee8)
  • È stata aggiunta un'API isFocusMeteringSupported in CameraInfo che consente alle applicazioni di verificare se l'azione di misurazione della messa a fuoco specificata è supportata o meno sulla fotocamera attuale. (Ib45ae, b/188606490)
  • È stata esposta l'API getResolutionInfo per fornire le informazioni sulla risoluzione per Anteprima, Acquisizione di immagini e Analisi di immagini. (I2b613, b/188600718)
  • Le seguenti API sperimentali sono state promosse ad API ufficiali: CameraXConfig.Builder#setAvailableCamerasLimiter(), CameraXConfig.Builder#setMinimumLoggingLevel(), CameraXconfig.Builder#setSchedulerHandler(), CameraXConfig#getAvailableCamerasLimiter(), CameraXConfig#getMinimumLoggingLevel(), CameraXConfig#getCameraExecutor(), CameraXConfig#getSchedulerHandler(). (I2ade2)
  • È stata esposta l'interfaccia CameraProvider per fornire l'accesso a un insieme di fotocamere. (I1a7b1)
  • Promuovi l'API UseCaseGroup sperimentale per camera-core, camera-lifecycle e camera-video. Sono stati aggiunti ViewPort#getLayoutDirection, ViewPort.Builder#setLayoutDirection e ViewPort.Builder#setScaleType per la personalizzazione dell'area visibile. (I7cee8)

Versione 1.1.0-alpha05

2 giugno 2021

androidx.camera:camera-camera2:1.1.0-alpha05, androidx.camera:camera-core:1.1.0-alpha05 e androidx.camera:camera-lifecycle:1.1.0-alpha05 vengono rilasciati. La versione 1.1.0-alpha05 contiene questi commit.

Modifiche all'API

  • Corso Camera2CameraFilter rimosso. Suggerire di selezionare la videocamera tramite CameraFilter e recuperare CameraCharacteristics o altre informazioni relative a Camera2 tramite Camera2CameraInfo, se necessario. (Ib887c)
  • Le API ExperimentalCameraFilter non sono più in fase sperimentale e diventano API formali. Possono essere utilizzati senza attivazione annotata. (I4bc94)
  • È stata aggiunta l'API dello stato della videocamera esposta tramite CameraInfo#getCameraState(). (Ia86b4)
  • È stata aggiunta l'API sperimentale CameraInfo#getCameraSelector() che restituisce un selettore della videocamera univoco per la videocamera (I77f9f)

Correzioni di bug

  • È stato risolto il problema per cui ListenableFuture restituito in setZoomRatio e setLinearZoom non può essere completato su alcuni dispositivi Android 11 (I716d7).
  • Accelerare il passaggio da una videocamera all'altra e ridurre la frequenza di errori del dispositivo della videocamera (I34c99)
  • È stato sostituito ExperimentalUseCaseGroupLifecycle con ExperimentalUseCaseGroup. (I3b2ef, b/159033688)

Versione 1.1.0-alpha04

21 aprile 2021

androidx.camera:camera-camera2:1.1.0-alpha04, androidx.camera:camera-core:1.1.0-alpha04 e androidx.camera:camera-lifecycle:1.1.0-alpha04 vengono rilasciati. La versione 1.1.0-alpha04 contiene questi commit.

Correzioni di bug

  • È stata corretta una perdita di memoria causata da più thread che accedevano contemporaneamente alla stessa raccolta. La perdita di memoria potrebbe causare la conservazione dell'attività o del frammento da parte di un'istanza di Anteprima. (I7b4b8)
  • È stata sostituita l'annotazione @Experimental con @RequiresOptIn per le API sperimentali. Per chiamare le API sperimentali, utilizza androidx.annotation.OptIn anziché androidx.annotation.experimental.UseExperimental deprecato. (Iff226)
  • È stato corretto il ripristino di Image Capture con il flash attivato/automatico che consente di acquisire immagini sbiadite su Samsung Galaxy S7. (I30001)
  • È stata aggiunta un'API CameraState che verrà esposta tramite CameraInfo. (I75392)

Versione 1.1.0-alpha03

24 marzo 2021

androidx.camera:camera-camera2:1.1.0-alpha03, androidx.camera:camera-core:1.1.0-alpha03 e androidx.camera:camera-lifecycle:1.1.0-alpha03 vengono rilasciati. La versione 1.1.0-alpha03 contiene questi commit.

Correzioni di bug

  • Formato JPEG di output per ImageCapture#OnImageCapturedCallback quando le modalità Estensioni sono attive. (I0d7b1)
  • È stato corretto l'errore di inizializzazione sui dispositivi UMIDIGI BISON (I57d9e, b/180818665)
  • È stata corretta l'anteprima allungata del Samsung A3 in PreviewView. (Iacb30, b/180121821)

Versione 1.1.0-alpha02

24 febbraio 2021

androidx.camera:camera-camera2:1.1.0-alpha02, androidx.camera:camera-core:1.1.0-alpha02 e androidx.camera:camera-lifecycle:1.1.0-alpha02 vengono rilasciati. La versione 1.1.0-alpha02 contiene questi commit.

Modifiche all'API

  • È stata aggiunta un'API ProcessCameraProvider.getAvailableCameraInfos() per recuperare direttamente le informazioni sulle videocamere disponibili, che possono essere tutte le videocamere del dispositivo o quelle selezionate dall'CameraSelector fornito in CameraXConfig.Builder.setAvailableCamerasLimiter(CameraSelector). (Ieac08)

Correzioni di bug

  • Ora CameraX tenta di aprire forzatamente una fotocamera al primo tentativo, il che potrebbe comportare il furto della fotocamera da parte di altri client della fotocamera quando la sua app ha una priorità più alta. (Iab069, b/175820568)
  • È stato corretto l'errore del test Robolectric quando viene utilizzato setAvailableCamerasLimiter in CameraXConfig. (Ice307)
  • Questa modifica rileva l'eccezione quando la coda di immagini è al massimo in ImageAnalysis. Pertanto, anziché arrestarsi in modo anomalo, potresti notare che altri casi d'uso sono bloccati o lenti, ad esempio l'anteprima bloccata/lenta. (Ic12da, b/175851631)
  • È stato corretto ExtensionsErrorListener per segnalare gli errori quando sono associati solo Anteprima o ImageCapture. (I5ae39).
  • È stato corretto il problema di regressione delle prestazioni di Image Capture, rimuovendo la convalida della posizione dell'immagine salvata prima di scattare una foto. Dopo aver apportato questa modifica, se la destinazione di salvataggio non è valida, ci vorrà più tempo per ricevere la risposta di errore perché verrà tentata la salvataggio dell'immagine dopo lo scatto della foto. (I1fd4e, b/177061560)
  • È stata corretta la regressione delle prestazioni di ImageCapture con OutputFileOptions di tipo "File". (I5164a, b/177061560)
  • Documentazione aggiornata per sconsigliare l'utilizzo di ProcessCameraProvider.configureInstance(...) dal codice libreria. (Ib8a9f)

Versione 1.1.0-alpha01

27 gennaio 2021

Vengono rilasciate le funzionalità androidx.camera:camera-camera2:1.1.0-alpha01, androidx.camera:camera-core:1.1.0-alpha01 e androidx.camera:camera-lifecycle:1.1.0-alpha01. La versione 1.1.0-alpha01 contiene questi commit.

Correzioni di bug

  • È stata inclusa una soluzione alternativa per i dati delle immagini corrotti intermittenti nei file JPEG sulla fotocamera posteriore del SM-G930T. (I52001, b/159831206)
  • È stato risolto il problema IllegalArgumentException che si verificava quando tutte le dimensioni supportate per l'anteprima erano inferiori a 640 x 480 e le dimensioni di visualizzazione erano superiori a 640 x 480. (I2a63c, b/150506192)
  • Le risorse nelle librerie senza risorse pubbliche dichiarate esplicitamente (ad es. tramite public.xml) ora sono private per impostazione predefinita. (Ia1dcc, b/170882230)

Camera-Camera2, Camera-Core e Camera-Lifecycle versione 1.0.2

Versione 1.0.2

29 settembre 2021

androidx.camera:camera-camera2:1.0.2, androidx.camera:camera-core:1.0.2 e androidx.camera:camera-lifecycle:1.0.2 vengono rilasciati. La versione 1.0.2 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema per cui le foto acquisite sono sfocate in modalità MAXIMIZE_QUALITY. (I173a9, b/193823892)
  • È stato risolto il problema a causa del quale l'immagine acquisita con Flash era scura su molti dispositivi. (I4e510)

Camera-Camera2, Camera-Core e Camera-Lifecycle versione 1.0.1

Versione 1.0.1

21 luglio 2021

androidx.camera:camera-camera2:1.0.1, androidx.camera:camera-core:1.0.1 e androidx.camera:camera-lifecycle:1.0.1 vengono rilasciati. La versione 1.0.1 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema per cui ListenableFuture restituito in setZoomRatio e setLinearZoom non può essere completato su alcuni dispositivi Android 11 (I716d7)

  • È stato risolto il problema per cui la videocamera si blocca nello stato di chiusura della videocamera su alcuni dispositivi e causa un'anteprima nera. (I34c99)

Versione 1.0.0 di Camera-Camera2, Camera-Core e Camera-Lifecycle

Versione 1.0.0

5 maggio 2021

androidx.camera:camera-camera2:1.0.0, androidx.camera:camera-core:1.0.0 e androidx.camera:camera-lifecycle:1.0.0 vengono rilasciati. La versione 1.0.0 contiene questi commit.

Funzionalità principali della versione 1.0.0

  • CameraX supporta Anteprima, Image Capture e Analisi
  • CameraX gestisce il ciclo di vita della fotocamera all'interno di un'API facile da usare
  • CameraX mira a fornire un livello di compatibilità che risolva molti problemi nell'ecosistema delle fotocamere Android

Problemi noti

Versione 1.0.0-rc05

21 aprile 2021

androidx.camera:camera-camera2:1.0.0-rc05, androidx.camera:camera-core:1.0.0-rc05 e androidx.camera:camera-lifecycle:1.0.0-rc05 vengono rilasciati. La versione 1.0.0-rc05 contiene questi commit.

Correzioni di bug

  • La funzionalità di acquisizione di immagini fisse con flash On/Auto scatta immagini sbiadite su Samsung Galaxy S7. (I30001)

Versione 1.0.0-rc04

24 marzo 2021

androidx.camera:camera-camera2:1.0.0-rc04, androidx.camera:camera-core:1.0.0-rc04 e androidx.camera:camera-lifecycle:1.0.0-rc04 vengono rilasciati. La versione 1.0.0-rc04 contiene questi commit.

Correzioni di bug

  • È stato corretto l'errore di inizializzazione sui dispositivi UMIDIGI BISON (I57d9e, b/180818665)

Versione 1.0.0-rc03

24 febbraio 2021

androidx.camera:camera-camera2:1.0.0-rc03, androidx.camera:camera-core:1.0.0-rc03 e androidx.camera:camera-lifecycle:1.0.0-rc03 vengono rilasciati. La versione 1.0.0-rc03 contiene questi commit.

Correzioni di bug

  • Correggi l'errore di formato nel documento di ProcessCameraProvider#getInstance
  • È stato corretto l'errore del test Robolectric quando viene utilizzato setAvailableCamerasLimiter in CameraXConfig.
  • È stata corretta la regressione del rendimento di ImageCapture rimuovendo la convalida della posizione di salvataggio delle immagini prima di scattare una foto. Dopo aver apportato questa modifica, se la destinazione di salvataggio non è valida, ci vorrà più tempo per ricevere la risposta di errore perché verrà tentata la salvataggio dell'immagine dopo lo scatto della foto
  • Questa modifica individua l'eccezione quando la coda delle immagini è al massimo in ImageAnalysis. Pertanto, anziché un arresto anomalo, potresti notare che altri casi d'uso sono bloccati o lenti, ad esempio l'anteprima bloccata/lenta.
  • È stata inclusa una soluzione alternativa per i dati delle immagini corrotti intermittenti nei file JPEG sulla fotocamera posteriore del SM-G930T. (I52001, b/159831206)
  • Questa modifica rileva l'eccezione quando la coda di immagini è al massimo in ImageAnalysis. Pertanto, anziché arrestarsi in modo anomalo, potresti notare che altri casi d'uso sono bloccati o lenti, ad esempio l'anteprima bloccata/lenta. (Ic12da, b/175851631)
  • È stato corretto l'errore del test Robolectric quando viene utilizzato setAvailableCamerasLimiter in CameraXConfig. (Ice307)
  • È stata corretta la regressione del rendimento di ImageCapture rimuovendo la convalida della posizione di salvataggio delle immagini prima di scattare una foto. Dopo aver apportato questa modifica, se la destinazione di salvataggio non è valida, ci vorrà più tempo per ricevere la risposta di errore perché verrà tentata la salvataggio dell'immagine dopo lo scatto della foto. (I1fd4e, b/177061560)
  • È stata corretta la regressione delle prestazioni di ImageCapture con OutputFileOptions di tipo "File". (I5164a, b/177061560)

Versione 1.0.0-rc02

27 gennaio 2021

androidx.camera:camera-camera2:1.0.0-rc02, androidx.camera:camera-core:1.0.0-rc02 e androidx.camera:camera-lifecycle:1.0.0-rc02 vengono rilasciati. La versione 1.0.0-rc02 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema IllegalArgumentException che si verificava quando tutte le dimensioni supportate per l'anteprima erano inferiori a 640 x 480 e la dimensione di visualizzazione era superiore a 640 x 480. (b/150506192)
  • Limita il numero di tentativi di riapertura della videocamera. Durante il tentativo di ripristino da determinati problemi all'apertura della fotocamera, CameraX non tenterà più di riaprirla a tempo indeterminato, ma si ferma dopo un nuovo tentativo per 10 secondi.I435d2

  • È stato risolto il problema di IllegalArgumentException che si è verificato quando tutte le dimensioni supportate in anteprima sono inferiori a 640 x 480 e le dimensioni di visualizzazione sono superiori a 640 x 480. (I2a63c, b/150506192)

Versione 1.0.0-rc01

16 dicembre 2020

androidx.camera:camera-camera2:1.0.0-rc01, androidx.camera:camera-core:1.0.0-rc01 e androidx.camera:camera-lifecycle:1.0.0-rc01 vengono rilasciati. La versione 1.0.0-rc01 contiene questi commit.

Modifiche all'API

  • Sono stati modificati CameraFilter e Camera2Filter in modo da includere CameraInfo. (I6883d)
  • È stata aggiunta la classe sperimentale Camera2CameraControl per consentire l'interoperabilità con le API Camera2 dinamicamente. (I45cf3)
  • È stato rinominato Camera2CameraInfo#fromCameraInfo in #from. (Ia2bd6)
  • È stata aggiunta un'API sperimentale setAvailableCamerasLimiter a CameraXConfig per consentire alle app di ottimizzare la latenza di inizializzazione evitando di inizializzare le fotocamere inutilizzate. (I6cf88)
  • È stato aggiunto il metodo sperimentale CameraXConfig.Builder#setMinimumLoggingLevel() per consentire l'impostazione di un livello minimo di logging per i log di CameraX. Se non viene configurato, il valore predefinito è Log#DEBUG. (Ic3245)

Correzioni di bug

  • Soluzione alternativa per la corruzione intermittente dei dati delle immagini nelle JPEG sulla fotocamera posteriore SM-G930V. (I5aca5, b/159831206)
  • È stato risolto il problema per cui non vengono ricevuti risultati quando si scattano foto con il flash sempre attivo/acceso e l'ambiente è buio sui dispositivi Samsung SM-A716. (If98b2, b/172036589)
  • È stato risolto il problema per cui l'anteprima non può essere interrotta chiamando Preview.setSurfaceProvider(null). (I3ac18).
  • È stato risolto il problema di orientamento durante l'acquisizione di immagini 4:3 su alcuni dispositivi. (I0e3fb, b/171492111)

Versione 1.0.0-beta12 di Camera, Camera2, Core e Lifecycle

11 novembre 2020

androidx.camera:camera-camera2:1.0.0-beta12, androidx.camera:camera-core:1.0.0-beta12 e androidx.camera:camera-lifecycle:1.0.0-beta12 vengono rilasciati. La versione 1.0.0-beta12 contiene questi commit.

Correzioni di bug

  • Il flash automatico è disattivato sui dispositivi Samsung A3 per correggere l'arresto anomalo quando scatti una foto con la modalità flash automatico AE sui dispositivi Samsung A3. (Ia5fe3, b/157535165)
  • È stato risolto un problema per cui l'anteprima veniva allungata sui dispositivi Nexus 4 con Android L (livelli API 21 e 22). (I4d407, b/158749159)
  • L'implementazione della classe base OnImageCapturedCallback#onCaptureSuccess non chiude più l'immagine. Questo serve a evitare comportamenti inaspettati per gli sviluppatori. Gli sviluppatori non devono fare affidamento su super.onCaptureSuccess per chiudere l'immagine. (Ifbf9c).
  • La variante androidx dell'annotazione sperimentale è stata ritirata per garantire la parità con Kotlin. È stato sostituito dall'annotazione RequestsOptIn e il linter rivolto a Java è stato aggiornato per supportare sia la nuova annotazione Kotlin sia la nuova variante di Androidx. (I52495, b/151331381)

Camera-Camera2 versione 1.0.0-beta11

14 ottobre 2020

androidx.camera:camera-camera2:1.0.0-beta11 viene rilasciato. La versione 1.0.0-beta11 contiene questi commit.

Nuove funzionalità

  • Supporta l'API CONTROL_ZOOM_RATIO di Android 11 per lo zoom su dispositivi Android 11 o versioni successive contenenti CONTROL_ZOOM_RATIO_RANGE valido. (I62cc6)

Correzioni di bug

  • È stato risolto il problema NumberFormatException che si verifica quando l'ID videocamera non è un numero intero. (Ib2228)
  • È stata migliorata la latenza dell'inizializzazione di CameraX e di bindToLifecycle (I61dc5)
  • La creazione di UseCases non richiede l'inizializzazione di CameraX per essere completata. Tutte le configurazioni specifiche dell'implementazione vengono impostate su UseCase una volta che è associato a un'istanza Camera, che per l'API pubblica è ProcessCameraProvider.bindToLifecycle(). (Ia5411)
  • <UseCase>.getTargetRotation() restituirà Surface.ROTATION_0 se viene chiamato prima di essere associato a un'istanza Camera, a meno che non sia stata impostata una rotationTarget su Builder o UseCase. (I80fcd)

Camera-Core versione 1.0.0-beta11

14 ottobre 2020

androidx.camera:camera-core:1.0.0-beta11 viene rilasciato. La versione 1.0.0-beta11 contiene questi commit.

Nuove funzionalità - Supporta l'API CONTROL_ZOOM_RATIO di Android 11 per lo zoom su dispositivi Android 11 o versioni successive contenenti CONTROL_ZOOM_RATIO_RANGE valido. (I62cc6)

Correzioni di bug

  • È stato risolto il problema NumberFormatException che si verifica quando l'ID videocamera non è un numero intero. (Ib2228)
  • La creazione di casi d'uso non richiede l'inizializzazione di CameraX per essere completata. Tutte le configurazioni specifiche dell'implementazione vengono impostate su UseCase una volta che è associato a un'istanza Camera, che per l'API pubblica è ProcessCameraProvider.bindToLifecycle(). (Ia5411)
  • <UseCase>.getTargetRotation() restituirà Surface.ROTATION_0 se viene chiamato prima di essere associato a un'istanza Camera, a meno che non sia stata impostata una rotationTarget su Builder o UseCase. (I80fcd)

Camera-Core versione 1.0.0-beta10

23 settembre 2020

androidx.camera:camera-core:1.0.0-beta10 viene rilasciato. La versione 1.0.0-beta10 contiene questi commit.

Correzioni di bug

  • Correzione di un bug nella convalida della destinazione di salvataggio dei file per l'acquisizione di immagini (I8c565, b/167697553)

Camera-Camera2 versione 1.0.0-beta10

23 settembre 2020

Viene rilasciato androidx.camera:camera-camera2:1.0.0-beta10. La versione 1.0.0-beta10 contiene questi commit.

Correzioni di bug

Camera-Camera2 Versione 1.0.0-beta09

16 settembre 2020

androidx.camera:camera-camera2:1.0.0-beta09 viene rilasciato. La versione 1.0.0-beta09 contiene questi commit.

Modifiche all'API

  • Anziché fornire metodi statici, Camera2CameraInfo prende un'istanza di CameraInfo al momento della creazione per recuperare le informazioni relative a Camera2. (I5b844).

Correzioni di bug

  • È stato risolto un problema relativo alle proporzioni del target sui dispositivi tablet. Quando le proporzioni target sono impostate su AspectRatio.RATIO_16_9, devi selezionare una dimensione 16:9. (Ib7fcf, b/151969438)
  • Lancia un InitializationException per consentire all'app di gestire in modo elegante l'errore AssertionError che si è verificato durante la creazione di CameraCharacteristics. (I89c8c, b/160524721)
  • Sono state aggiunte interfacce sperimentali per ExposureCompensation (If96c7)

Camera-Core versione 1.0.0-beta09

16 settembre 2020

androidx.camera:camera-core:1.0.0-beta09 viene rilasciato. La versione 1.0.0-beta09 contiene questi commit.

Modifiche all'API

  • è stato corretto il bug in cui l'area visibile è contrassegnata come non null in UseCaseGroup. Gli sviluppatori devono poter creare un'area visibile senza impostarla. (Ie3d2e)
  • Sono state aggiunte interfacce sperimentali per ExposureCompensation (If96c7)
  • Consenti la rotazione arbitraria del target per l'anteprima. Le informazioni sulla trasformazione vengono calcolate e restituite all'utente in tempo reale tramite un nuovo TranformationInfoListener callback. (I21470)

Correzioni di bug

  • È stato risolto il problema per cui il flash su alcuni dispositivi non si spegneva. Il problema si verifica quando la modalità flash è impostata su FLASH_MODE_ON per scattare una foto e viene modificata in FLASH_MODE_OFF quando viene attivato il flash. Il sintomo è l'attivazione della modalità torcia. (Ib4451, b/162568128)
  • Forza PreviewView a utilizzare TextureView se l'effetto di estensione è attivato e l'implementazione della libreria del fornitore deve eseguire una procedura speciale sulla superficie di output. (I0c3cc)
  • È stato corretto la perdita di attività/frammenti quando un contesto di attività/frammento viene passato a ProcessCameraProvider.getInstance(Context).

Problemi noti

  • Quando ViewPort è impostato, il rettangolo di ritaglio di ImageCapture potrebbe non essere corretto sui dispositivi che ruotano il buffer immagine in HAL. Questo problema verrà risolto nella prossima release.

Camera-Camera2 versione 1.0.0-beta08

19 agosto 2020

androidx.camera:camera-camera2:1.0.0-beta08 viene rilasciato. La versione 1.0.0-beta08 contiene questi commit.

Correzioni di bug

  • È stato ottimizzato bindToLifecycle per l'esecuzione rapida nel thread principale. (I1d57e)
  • DisplayOrientedMeteringPointFactory riceve un'istanza CameraInfo anziché un CameraSelector, quindi esiste una mappatura diretta della videocamera per la quale la factory genererà i punti. Tutte le classi che utilizzano DisplayOrientedMeteringPointRecovery utilizzano anche un'istanza CameraInfo anziché CameraSelector. (I400c1)
  • È stato risolto il problema di raggruppamento delle dimensioni delle proporzioni con risoluzione automatica per cui viene selezionata una dimensione mod16 16:9 (864 x 480) quando l'impostazione della risoluzione target è 2016 x 1080 e sono supportate altre dimensioni 1920 x 1080 16:9. (I53167, b/159363774)
  • Risolvere il problema di CameraControl che non funziona a causa di una condizione di gara (I2279f, b/152333890, b/160714166)

Camera-Core versione 1.0.0-beta08

19 agosto 2020

androidx.camera:camera-core:1.0.0-beta08 viene rilasciato. La versione 1.0.0-beta08 contiene questi commit.

Modifiche alle API

  • DisplayOrientedMeteringPointFactory accetta un'istanza CameraInfo instead of a CameraSelector, quindi esiste una mappatura diretta per la Camera per la quale la factory genererà i punti. Tutte le classi che utilizzano DisplayOrientedMeteringPointFactory accettano anche un'istanza CameraInfo anziché CameraSelector. (I400c1)

Correzioni di bug

  • Per l'acquisizione di immagini, sovrascrivi il flag di rotazione orizzontale nei metadati in base alla direzione della fotocamera. (I28499)
  • L'inizializzazione non dovrebbe più arrestarsi in modo anomalo quando si utilizza un contesto che non restituisce un oggetto Application da Context.getApplicationContext(). (I3d3c9, b/160817073)

Camera-Camera2 versione 1.0.0-beta07

22 luglio 2020

Viene rilasciato androidx.camera:camera-camera2:1.0.0-beta07. La versione 1.0.0-beta07 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema relativo all'allungamento dell'anteprima sui dispositivi precedenti con Android 5.0. (I0c03a)
  • Sono escluse alcune dimensioni JPEG supportate che causano un problema di WYSIWYG su alcuni dispositivi. (Ib5128)

Camera-Core versione 1.0.0-beta07

22 luglio 2020

androidx.camera:camera-core:1.0.0-beta07 viene rilasciato. La versione 1.0.0-beta07 contiene questi commit.

Modifiche all'API

  • Unisci lo stile di adattamento FIT_CENTER, FIT_START e FIT_END con FIT. FITsignifica che il rettangolo di ritaglio restituito sarà il rettangolo del sensore massimo possibile. (Ia73c3)
  • Il rettangolo di ritaglio dell'anteprima è configurato in base all'area visibile. Solo l'area coperta dal rettangolo di ritaglio deve essere visibile agli utenti finali. (I142a4)

Correzioni di bug

  • È stato risolto il problema relativo all'allungamento dell'anteprima sui dispositivi precedenti con Android 5.0. (I0c03a)
  • È stato risolto il problema relativo all'eccezione ConcurrentModificationException quando si annulla il binding dei casi d'uso. (I371c0)

Camera-Camera2 Versione 1.0.0-beta06

24 giugno 2020

androidx.camera:camera-camera2:1.0.0-beta06 viene rilasciato. La versione 1.0.0-beta06 contiene questi commit.

Modifiche all'API

  • Sono state aggiunte interfacce sperimentali per filtrare le videocamere in base a ID videocamera e CameraCharacteristics. (I28f61)

Correzioni di bug

  • È stato risolto il problema per cui startFocusAndMetering non riesce a mettere a fuoco correttamente su Samsung Galaxy S7. (If3be7, b/159039233)
  • Correggere il problema relativo alla chiusura della videocamera dopo l'uscita dall'app. (I7a7b3)
  • Correggere i problemi di interruzione dell'anteprima dovuti al cambio ripetuto della fotocamera quando si utilizza l'implementazione di PreviewView di SurfaceView (I920ce)
  • CameraControl#startFocusAndMetering non andrà a buon fine se nessuno dei MeteringPoint specificati può generare rettangoli di misurazione validi. (Id53ce)

Camera-Core versione 1.0.0-beta06

24 giugno 2020

Viene rilasciato androidx.camera:camera-core:1.0.0-beta06. La versione 1.0.0-beta06 contiene questi commit.

Modifiche alle API

  • Sono state aggiunte interfacce sperimentali per filtrare le videocamere in base all'ID e alle caratteristiche della videocamera. (I28f61)

Correzioni di bug

  • Ora CameraX può essere configurato con ProcessCameraProvider#configureInstance() prima di chiamare ProcessCameraProvider#getInstance(). Ciò consente di personalizzare CameraXConfig senza dover implementare CameraXConfig.Provider nella classe Application dell'app. (Ia1a8d)
  • CameraControl#startFocusAndMetering non andrà a buon fine se nessuno dei MeteringPoint specificati può generare rettangoli di misurazione validi. (Id53ce)

Camera-Camera2 Versione 1.0.0-beta05

10 giugno 2020

androidx.camera:camera-camera2:1.0.0-beta05 viene rilasciato. La versione 1.0.0-beta05 contiene questi commit.

Correzioni di bug

  • Correzione dell'arresto anomalo all'avvio dell'app durante l'inizializzazione di CameraX quando lo smartphone è in modalità Non disturbare. Un InitializationException contiene un CameraUnavailableException che verrà impostato sul ListenableFuture del risultato dell'inizializzazione anziché causare l'arresto anomalo dell'applicazione. (I9909a, b/149413835)
  • È stato corretto l'arresto anomalo durante la chiamata a startFocusAndMetering sui dispositivi in cui CONTROL_AF_STATE è nullo. (Ife55e, b/157084254)

Camera-Core versione 1.0.0-beta05

10 giugno 2020

androidx.camera:camera-core:1.0.0-beta05 viene rilasciato. La versione 1.0.0-beta05 contiene questi commit.

Modifiche alle API

  • Correzione dell'arresto anomalo all'avvio dell'app durante l'inizializzazione di CameraX quando lo smartphone è in modalità Non disturbare. Un'istruzione InitializationException contiene un valore CameraUnavailableException che verrà impostato su ListenableFuture del risultato dell'inizializzazione anziché causare l'arresto anomalo dell'applicazione. (I9909a, b/149413835)

Correzioni di bug

  • Sono stati aggiornati i file Javadoc di setTargetResolution e setTargetRotation. (Iae16f)

Camera-Camera2 Versione 1.0.0-beta04

27 maggio 2020

Viene rilasciato androidx.camera:camera-camera2:1.0.0-beta04. La versione 1.0.0-beta04 contiene questi commit.

Correzioni di bug

  • Le applicazioni possono impostare i parametri della richiesta di acquisizione di Camera2 tramite Camera2Interop senza causare un arresto anomalo. Tieni presente che in caso di problemi dovuti alla sostituzione di parametri. La stabilità e il comportamento non sono garantiti quando si sostituiscono i parametri utilizzando Camera2Interop. (Ibe5a1, b/149103700)
  • L'inizializzazione automatica viene corretta quando si utilizza un'app su un dispositivo che utilizza una pseudo-lingua. (I3bef3, b/154767663)
  • Il log degli errori relativo al caso d'uso scollegato è stato convertito in un log di debug su Camera2CameraImpl. (I1a565, b/154422490)
  • È stato risolto il problema a causa del quale l'immagine scattata a volte risultava troppo scura anche se il flash era attivo. (I5d9fa, b/149729613)
  • È stato corretto un bug a causa del quale il buffer in ImageProxy da ImageCapture non veniva riavvolto (I0c455, b/153249512)
  • Sono stati risolti i problemi relativi al binding di ImageCapture solo: (1) Impossibile scattare foto con MAX_QUALITY; (2) Generazione di una qualità dell'immagine scadente perché l'esposizione automatica non funziona. (I17782, b/145326998)
  • È stata migliorata l'affidabilità della riapertura della fotocamera quando CameraX viene disconnesso da un altro processo o percorso di codice che ruba la fotocamera (I1fbc3, b/153714651)

Camera-Core versione 1.0.0-beta04

27 maggio 2020

androidx.camera:camera-core:1.0.0-beta04 viene rilasciato. La versione 1.0.0-beta04 contiene questi commit.

Modifiche all'API

  • Aggiunge un'API sperimentale, CameraXConfig.Builder#setSchedulerHandler(), per impostare il gestore utilizzato internamente dallo stack della fotocamera CameraX. Questa nuova API, insieme a CameraXConfig.Builder#setCameraExecutor(), dovrebbe consentire il controllo completo sui thread utilizzati dall'elenco di videocamere CameraX. (I7bf32, b/121160431)

Correzioni di bug

  • Corregge l'arresto anomalo in ImageAnalysis quando si accede a ImageProxy dopo la chiusura di ImageReaderProxy. In questo modo, tutti i ImageProxy ricevuti dal Analyzer devono essere chiusi prima della chiusura del ImageReaderProxy. (I4b299, b/145956416, b/154155377, b/156357269)
  • Il parametro CameraInfo è stato rimosso da PreviewView#createSurfaceProvider(), PreviewView ora lo recupera internamente da SurfaceRequest. (If18f0, b/154652477)
  • L'inizializzazione automatica viene corretta quando si utilizza un'app su un dispositivo che utilizza una pseudo-lingua. (I3bef3, b/154767663)
  • È stato risolto il problema a causa del quale l'immagine scattata a volte risultava troppo scura anche se il flash era attivo. (I5d9fa, b/149729613)
  • È stato risolto un problema relativo a ImageAnalysis per cui più chiamate a setAnalyzer/clearAnalyzer impedivano all'analizzatore di ricevere le immagini da analizzare. (I6169f, b/151605317, b/153514544)
  • È stato corretto un bug a causa del quale il buffer in ImageProxy da ImageCapture non veniva riavvolto (I0c455, b/153249512)
  • È stato risolto il problema per cui non sempre viene selezionata la prima videocamera nell'elenco supportato di CameraManager. (I4c624, b/153418028)
  • È stato corretto un arresto anomalo intermittente causato dall'impostazione Preview.SurfaceProvider che non rilascia la superficie richiesta in precedenza. “java.lang.IllegalStateException: Camera surface session should only fail with request cancellation” (I8e4e7, b/155936225)

Camera-Camera2 Versione 1.0.0-beta03

15 aprile 2020

androidx.camera:camera-camera2:1.0.0-beta03 viene rilasciato. La versione 1.0.0-beta03 contiene questi commit.

Correzioni di bug

  • Correzioni per supportare il rilascio di camera-core

Camera-Core versione 1.0.0-beta03

15 aprile 2020

androidx.camera:camera-core:1.0.0-beta03 viene rilasciato. La versione 1.0.0-beta03 contiene questi commit.

Correzioni di bug

  • È stata corretta la regressione da beta03 per cui la chiamata di bindToLifecycle() con zero UseCase causava un'eccezione generata. Ciò ha impedito il recupero di un Camera senza l'associazione di un UseCase.

Camera-Camera2 Versione 1.0.0-beta02

1° aprile 2020

androidx.camera:camera-camera2:1.0.0-beta02 viene rilasciato. La versione 1.0.0-beta02 contiene questi commit.

Correzioni di bug

  • È stato corretto il valore ImageInfo.getRotationDegrees() del ImageProxy prodotto da ImageCapture in modo che corrisponda al valore di rotazione dell'orientamento EXIF. (Id4281, b/150802561)
  • Per utilizzare l'implementazione predefinita di CameraX/Camera2, non è più necessario ordinare in modo esplicito le dipendenze di CameraX all'interno di build.gradle. Nei casi in cui sia richiesta la dichiarazione di dipendenze rigorose, ora tutte le dipendenze di CameraX possono essere incluse nel file di compilazione. (I46e88)
  • È stato risolto il problema IllegalArgumentException che si verificava sui dispositivi con dimensioni del display inferiori a 640 x 480. (Ife3f2, b/150506192)
  • È stato corretto bindToLifecycle in modo che modifichi l'UseCase solo se si esegue il binding correttamente. In precedenza, quando si chiamava bindToLifecycle per eseguire i calcoli della risoluzione, l'UseCase veniva aggiornato. Ora non è più necessario aggiornare l'UseCase per eseguire i calcoli (I78d9e)

Camera-Core versione 1.0.0-beta02

1° aprile 2020

androidx.camera:camera-core:1.0.0-beta02 viene rilasciato. La versione 1.0.0-beta02 contiene questi commit.

Correzioni di bug

  • È stato corretto il valore ImageInfo.getRotationDegrees() del ImageProxy prodotto da ImageCapture in modo che corrisponda al valore di rotazione dell'orientamento EXIF. (Id4281, b/150802561)
  • È stato corretto bindToLifecycle in modo che modifichi l'UseCase solo se si esegue il binding correttamente. In precedenza, quando si chiamava bindToLifecycle per eseguire i calcoli della risoluzione, l'UseCase veniva aggiornato. Ora non è più necessario aggiornare l'UseCase per eseguire i calcoli (I78d9e)
  • È stato risolto un problema per cui la sessione di acquisizione del caso d'uso Preview non veniva aggiornata quando la superficie di anteprima cambiava dopo aver chiamato Preview.setSurfaceProvider() più volte.

Camera-Camera2 Versione 1.0.0-beta01

26 febbraio 2020

Viene rilasciato androidx.camera:camera-camera2:1.0.0-beta01. La versione 1.0.0-beta01 contiene questi commit.

Correzioni di bug

  • SurfaceRequest.setSurface(Surface) rinominato in SurfaceRequest.provideSurface(Surface) e SurfaceRequest.setWillNotComplete() in SurfaceRequest.willNotProvideSurface(). (I224fe)
  • È stato risolto un problema relativo alla proporzione di un'immagine salvata non corretta dopo aver modificato il valore di rotazione target utilizzando ImageCapture.setTargetRotation(). (I474ea, b/148763432)
  • È stata corretta l'inizializzazione delle varianti dell'app con ProGuard abilitato preservando il flag che imposta il provider CameraXConfig predefinito. (I2d6c1)

Camera-Core versione 1.0.0-beta01

26 febbraio 2020

androidx.camera:camera-core:1.0.0-beta01 viene rilasciato. La versione 1.0.0-beta01 contiene questi commit.

Modifiche all'API

  • ListenableFuture su SurfaceRequest.provideSurface() sostituito con Executor e Callback. In questo modo, l'API viene semplificata perché non richiede più la gestione delle eccezioni su provideSurface() e impone che il callback di provideSurface() non possa essere annullato. Questo serve a evitare arresti anomali sui dispositivi meno recenti causati dal rilascio prematuro delle piattaforme. L'oggetto SurfaceRequest.Result viene ora utilizzato per monitorare il modo in cui un SurfaceRequest utilizza il Surface fornito. (I7854b)
  • SurfaceRequest.setSurface(Surface) è stato rinominato in SurfaceRequest.provideSurface(Surface) e SurfaceRequest.setWillNotComplete() in SurfaceRequest.willNotProvideSurface(). (I224fe)

Correzioni di bug

  • È stato risolto un problema relativo alla proporzione di un'immagine salvata non corretta dopo aver modificato il valore di rotazione target utilizzando ImageCapture.setTargetRotation(). (I474ea, b/148763432)
  • È stato corretto l'inizializzazione delle varianti di app con ProGuard abilitato mantenendo il flag che imposta il provider CameraXConfig predefinito. (I2d6c1)
  • Documentazione aggiornata per le API di modalità flash per includere i possibili valori. (I4a3ec)

Camera-Camera2 versione 1.0.0-alpha10

10 febbraio 2020

androidx.camera:camera-camera2:1.0.0-alpha10 viene rilasciato. La versione 1.0.0-alpha10 contiene questi commit.

Correzioni di bug

  • Stabilità migliorata sui dispositivi INFO_SUPPORTED_HARDWARE_LEVEL_LEGACY garantendo che i Surface vengano conservati solo per la durata dell'utilizzo da parte di Camera2. (I9dac2)
  • È stato risolto il problema di sottoesposizione dell'anteprima sui dispositivi LEGACY regolando correttamente CONTROL_AE_TARGET_FPS_RANGE. (1224638)

Camera-Core versione 1.0.0-alpha10

10 febbraio 2020

androidx.camera:camera-core:1.0.0-alpha10 viene rilasciato. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche all'API

  • ImageCapture è stato aggiornato per consentire il salvataggio delle immagini in Uri e OutputStream. I metodi takePicture sovraccaricati sono stati combinati in un unico metodo. App di prova aggiornata in modo che utilizzi Uri come esempio canonico. (Ia3bec)
  • Preview.PreviewSurfaceProvider è stato rinominato in Preview.SurfaceProvider. I SurfaceProvider non richiedono più agli sviluppatori di creare il proprio ListenableFuture e l'aggiunta di un Surface avviene ora tramite un nuovo oggetto SurfaceRequest. Il metodo Preview.getPreviewSurfaceProvider() è stato rimosso a causa del potenziale uso improprio quando Preview è accoppiato ad altre classi come PreviewView. (I20105)
  • getTargetRotation() e getTargetName() aggiunti a Preview. (Iceee7)
  • Aggiunti getTargetRotation(), getBackpressureStrategy() e getImageQueueDepth() in ImageAnalysis. (I9d6d9)
  • getTargetRotation() e getCaptureMode() aggiunti in ImageCapture() (I5bc17)
  • Gli argomenti che in precedenza venivano passati in ImageCapture.OnImageSavedCallback.onError() e ImageCapture.OnImageCapturedCallback.onError() sono stati sostituiti da un unico argomento ImageCaptureException, che contiene ancora tutte le informazioni passate in precedenza.
  • L'argomento del file passato in precedenza in ImageCapture.OnImageSavedCallback.onImageSaved() è stato rimosso. (I750d2)
  • I corsi Preview e ImageCapture sono ora contrassegnati come finali. (I2500b)
  • API aggiornata con i metodi getZoomRatio(), getMaxZoomRatio(), getMinZoomRatio() e getLinearZoom() per l'unione di CameraInfo in getZoomState() che restituisce un'istanza ZoomState. (Ib19fe)
  • Sono stati rimossi i campi API OPTION_TARGET_CLASS e OPTION_TARGET_NAME da CameraXConfig in quanto sono destinati esclusivamente all'uso interno della libreria. Costruttore rimosso per CameraXConfig.Builder. (I96912)
  • È stato rimosso il requisito che l'app debba estendere Application per inizializzare CameraX. Ora CameraX verrà inizializzato con una configurazione Camera2 predefinita, a condizione che l'elemento camera-camera2 sia incluso nel build.gradle dell'applicazione. (I58ff5) (b/146923574)

Camera-Camera2 versione 1.0.0-alpha09

22 gennaio 2020

androidx.camera:camera-camera2:1.0.0-alpha09 viene rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

  • Aggiungi il percorso di interoperabilità camera2 per estrarre un ID fotocamera Camera2. Puoi estrarre l'ID videocamera da CameraInfo utilizzando Camera2CameraInfo.extractCameraId(). Il seguente esempio di codice mostra come utilizzarlo:

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

    La classe Camera2CameraInfo richiede ExperimentalCamera2Interop markerClass.

Camera-Core versione 1.0.0-alpha09

22 gennaio 2020

Viene rilasciato androidx.camera:camera-core:1.0.0-alpha09. La versione 1.0.0-alpha09 contiene questi commit.

Modifiche alle API

  • Il parametro SurfaceOrientedMeteringPointFactory useCaseForSurface è stato rinominato in useCaseForAspectRatio e la documentazione di riferimento è stata espansa.
  • I metodi FocusMeteringAction.Builder.from() sono sostituiti dai costruttori FocusMeteringAction.Builder().
  • DisplayOrientedMeteringPointFactory(android.content.Context, androidx.camera.core.CameraSelector, float, float) rimosso. Le applicazioni devono utilizzare il costruttore che accetta un parametro Display e deve passare la visualizzazione corrente.
  • Miglioramenti ai Javadoc per le API di messa a fuoco e misurazione relativi ai flag MeteringMode e 3A e all'utilizzo del parametro Display.
  • È stata ampliata la documentazione di riferimento per setZoomRatio e setLinearZoom.

Correzioni di bug

  • Sono stati risolti i problemi relativi alla chiusura e all'apertura delle videocamere che causavano un errore di controllo "Condizione preliminare".
  • È stato corretto un ConcurrentModificationException che poteva verificarsi durante l'utilizzo delle API torcia e zoom.
  • È stato risolto il problema relativo alla selezione delle risoluzioni più vicine alla risoluzione richiesta quando è disponibile una dimensione di dimensione mod16.
  • Le API startFocusMetering e cancelFocusMetering ora si comportano come descritto nella documentazione, con tempistiche corrette e potenzialmente restituendo errori quando si verificano.
  • È stato risolto il problema relativo alla richiesta di una risoluzione target specifica con un formato di ritaglio su un dispositivo che non supporta queste dimensioni. Ora, se disponibile, verrà selezionata una dimensione non ritagliata con una risoluzione sufficiente per delimitare la richiesta originale.

Camera-Camera2 versione 1.0.0-alpha08

18 dicembre 2019

androidx.camera:camera-camera2:1.0.0-alpha08 viene rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Problemi noti

  • Non tutte le opzioni di richiesta di acquisizione Camera2 funzionano quando si utilizza l'interoperabilità Camera2. Se l'opzione richiesta non è supportata, la sessione non si avvia e potrebbe verificarsi un errore come questo: 09-09 14:04:13.643 10117 26020 26036 E AndroidRuntime: java.lang.IllegalArgumentException: Unsupported session configuration combination

Correzioni di bug

  • È stato risolto il problema per cui si verificava una schermata nera di anteprima dopo aver ruotato o cambiato la fotocamera per i livelli API 21 e 22.

Modifiche all'API

  • Sperimentale: è stato aggiunto un percorso di interoperabilità camera2 per l'estrazione dell'ID fotocamera.

Camera-Core versione 1.0.0-alpha08

18 dicembre 2019

androidx.camera:camera-core:1.0.0-alpha08 viene rilasciato. La versione 1.0.0-alpha08 contiene questi commit.

Problemi noti

  • Le app che utilizzano PreviewView o CameraView potrebbero avere proporzioni errate. Questo accade dopo la messa in pausa o la ripresa su alcuni dispositivi FULL, come Pixel 2.

Correzioni di bug

  • Aggiornata la documentazione per FocusMeteringAction e CameraControl.
  • È stata implementata la funzionalità TorchControl per enableTorch() e getTorchState().

Modifiche all'API

  • Sono state nascoste le IntDef e le costanti IntDef sono state spostate all'esterno della definizione IntDef.
  • Elemento rotationDegrees spostato dal corso OnImageCaptureCallback a ImageInfo.
  • Elemento rotationDegrees spostato dal corso Analyzer a ImageInfo.

Camera-Camera2 versione 1.0.0-alpha07

4 dicembre 2019

androidx.camera:camera-camera2:1.0.0-alpha07 viene rilasciato. La versione 1.0.0-alpha07 di camera-camera2 contiene questi commit

  • Camera2Config è ora disponibile per l'utilizzo con l'inizializzazione e la configurazione di un'implementazione basata su Camera2 per CameraX. Ulteriori dettagli su come utilizzarlo durante l'inizializzazione sono disponibili nella sezione camera-core delle note di rilascio.
  • L'interoperabilità di Camera2 è ora contrassegnata come sperimentale e spostata in un pacchetto separato, androidx.camera.camera2.interop.

Camera-Core versione 1.0.0-alpha07

4 dicembre 2019

androidx.camera:camera-core:1.0.0-alpha07 viene rilasciato. La versione 1.0.0-alpha07 di camera-core contiene questi commit

Tieni presente che in questa release alpha sono presenti alcune modifiche sostanziali in vista della versione beta. Ti consigliamo di esaminare le modifiche e di condividere eventuali feedback nel gruppo Google CameraX. Agli sviluppatori che utilizzano CameraX nelle app sul Play Store consigliamo di attendere la release beta ufficiale prima di eseguire l'upgrade della libreria all'interno delle applicazioni.

Modifiche alle API

  • Importante: l'inizializzazione di CameraX è cambiata. Le applicazioni devono implementare CameraXConfig.Provider e utilizzare il valore predefinito Camera2Config fornito da androidx.camera.camera2. Un utilizzo tipico è:

    import androidx.camera.camera2.Camera2Config
    import androidx.camera.core.CameraXConfig
    
    public class MyCameraXApplication : Application(),  CameraXConfig.Provider {
        override fun getCameraXConfig(): CameraXConfig {
                return Camera2Config.defaultConfig(this)
        }
    }
    
  • La classe CameraX è stata rimossa. I metodi bindToLifecycle(), unbind(), unbindAll(), isBound() e hasCamera() precedentemente forniti dalla chiamata della classe CameraX sono ora disponibili tramite ProcessCameraProvider.

  • Un'istanza per processo di ProcessCameraProvider viene ottenuta in modo asincrono utilizzando il metodo statico ProcessCameraProvider.getInstance(), che restituisce un futuro ascoltabile, che fornisce ProcessCameraProvider al termine. Qui viene mostrato in onCreate() per un utilizzo tipico. Puoi effettuare chiamate a getInstance() in un secondo momento nel ciclo di vita dell'attività per posticipare la latenza di inizializzazione a un momento successivo (ad esempio quando un'azione dell'utente apre l'interfaccia utente della videocamera).

    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);
      }
    
  • È possibile aggiungere un ascoltatore all'oggetto ListenableFuture restituito da getInstance(). Ciò garantisce che il fornitore della videocamera possa essere recuperato da Future senza bloccare Future.get()

    cameraProviderFuture.addListener(Runnable {
      val cameraProvider = cameraProviderFuture.get()
      cameraProvider.bindToLifecycle(...)
    }, ContextCompat.getMainExecutor(this))
    
  • La selezione della fotocamera ora viene effettuata tramite un selettore di fotocamera, anziché un caso d'uso

    val cameraSelector = CameraSelector.Builder().requireLensFacing(LensFacing.BACK).build()
    
  • A CameraProvider.bindToLifecycle vengono assegnati il proprietario del ciclo di vita, il selettore della videocamera e i casi d'uso, che vengono poi associati al proprietario del ciclo di vita specificato ed eseguiti per la videocamera selezionata.

    cameraProvider.bindToLifecycle(this as LifecycleOwner,
           cameraSelector, preview, imageAnalysis)
    
  • Le classi del caso d'uso "Config" vengono rimosse. Crea invece direttamente casi d'uso, impostando le opzioni su ogni generatore di casi d'uso. Ad esempio:

    preview = Preview.Builder().setTargetAspectRatio(AspectRatio.RATIO_16_9).build()
    
  • Il caso d'uso Anteprima è stato aggiornato per accettare una superficie creata e gestita dall'applicazione al fine di garantire le best practice per Android. Ti consigliamo vivamente di utilizzare la classe di visualizzazione PreviewView fornita nel pacchetto camera-view.

    preview.setPreviewSurfaceProvider(previewView.previewSurfaceProvider)
    
  • Consulta la documentazione per l'attacco di una piattaforma gestita dall'app. In questi casi, l'app gestisce il ciclo di vita della piattaforma.

  • Importante: l'implementazione del metodo di analisi ImageAnalysis deve chiamare image.close() sulle immagini ricevute quando ha finito di utilizzarle. In caso contrario, le nuove immagini potrebbero non essere ricevute o la fotocamera potrebbe bloccarsi, a seconda dell'impostazione della contropressione. Per informazioni dettagliate, consulta le documentazioni di riferimento.

  • ImageAnalysis ImageReaderMode è ora impostato su una strategia di backpressure intdef.

  • ImageProxy.getImage() è contrassegnato come sperimentale. Le applicazioni devono annotare l'utilizzo, ad esempio tramite @androidx.camera.core.ExperimentalGetImage

  • Il requisito di annotazione UIThread per Analyzer è stato rimosso.

  • La funzione ImageAnalysis.clearAnalyzer() viene aggiunta per rimuovere un analizzatore.

  • Gli ascoltatori con più di un metodo sono stati rinominati in Callback:

    • ImageCapture.OnImageCapturedListener è diventata ImageCapture.OnImageCapturedCallback
    • ImageCapture.OnImageSavedListener è diventata ImageCapture.OnImageSavedCallback
    • VideoCapture.OnVideoSavedListener è diventata VideoCapture.OnVideoSavedCallback
  • Gli enum sono stati modificati in IntDef

  • Sono stati aggiunti i controlli zoom:

    • CameraControl.setLinearZoom()
    • CameraControl.setZoomRatio()
    • CameraInfo.getLinearZoom()
    • CameraInfo.getMaxZoomRatio()
    • CameraInfo.getZoomRatio()
  • CameraInfo.hasFlashUnit() viene aggiunto per determinare se è presente l'hardware della torcia/flash.

  • CameraInfo.isFlashAvailable() è stato rimosso. La torcia sostituisce la funzionalità del flash. Ulteriori dettagli sono inclusi nella documentazione di riferimento.

  • I campi ImageCapture.Metadata sono sostituiti dalle funzioni di accesso get/set/is.

  • startFocusMetering e cancelFocusMetering ora restituiscono ListenableFutures, che rappresenta l'operazione asincrona della chiamata.

  • MeteringPoints ora funzionano come handle per le azioni di misurazione e vengono prodotti dalle fabbriche. Le app devono utilizzare le fabbriche esistenti anziché quelle personalizzate.

Problemi risolti

  • È stato risolto il problema relativo allo scatto di una foto al momento della ripresa (dopo una pausa precedente in cui erano state scattate foto in attesa di completamento).
  • Problema noto: CameraControl.enableTorch() è funzionale, ma il valore ListenableFuture<Void> restituito è sempre un complete(success) futuro immediato, anche se non è presente un'unità flash. Le versioni future correggeranno questo problema con il comportamento finale: in assenza di unità Flash, enableTorch(true) non riesce immediatamente (non invia la richiesta a CaptureSession) e TorchState rimane disattivato.
  • Problema noto: i comandi startFocusAndMetering e cancelFocusAndMetering avviano e annullano la misurazione della messa a fuoco, ma restituiscono un valore completed (success) futuro immediato che non rappresenta il comportamento documentato. FocusMeteringResult da ListenableFuture<FocusMeteringResult> CameraControl.startFocusAndMetering() è un risultato falso che isFocusSuccessful() ed è sempre "falso", diverso dal comportamento previsto e documentato.
  • Problema noto: è in fase di sviluppo un'azienda di punti di misurazione da utilizzare con gli eventi di tocco PreviewView. Per il momento, le app che connettono piattaforme gestite personalizzate possono utilizzare le factory di punti di misurazione esistenti e, in caso contrario, non è disponibile alcuna funzionalità di messa a fuoco tocco per PreviewView.

Camera-Camera2 e Camera-Core versione 1.0.0-alpha06

9 ottobre 2019

androidx.camera:camera-camera2:1.0.0-alpha06 e androidx.camera:camera-core:1.0.0-alpha06 vengono rilasciati. Questi sono gli impegni inclusi in camera-camera2:1.0.0-alpha06 e gli impegni inclusi in camera-core:1.0.0-alpha06.

Nuove funzionalità

Modifiche all'impostazione delle proporzioni:

  • È stato aggiunto setTargetAspectRatioMode(), che accetta un argomento enum. Imposta la modalità Formato con le opzioni RATIO_4_3 o RATIO_16_9 anziché con un formato arbitrario. Ciò riflette il fatto che dalla fotocamera vengono forniti solo alcuni formati, anziché un rapporto arbitrario.
    • Al momento, gli unici rapporti disponibili sono 16:9 e 4:3. Nel caso del formato 1:1, solo alcuni dispositivi dispongono di questa opzione dalla fotocamera e solo a risoluzioni limitate. Le applicazioni che progettano un'interfaccia o un'elaborazione 1:1 devono utilizzare le opzioni più flessibili 16:9 o 4:3 e ritagliare il display o elaborare una sottoregione.
    • Queste proporzioni sono orientate in modo da utilizzare la massima area del sensore.
  • getTargetAspectRatio() è stato aggiunto alle API di configurazione dei casi d'uso e restituisce il formato dell'output del caso d'uso di destinazione.
  • Il metodo setTargetAspectRatio(Rational aspectRatio) è stato modificato in setTargetAspectRatioCustom(Rational aspectRatio) per ImageCapture. Se impostato, l'output di ImageCapture viene ritagliato di conseguenza.

API di esecuzione

  • Le seguenti funzioni accettano un parametro di esecuzione, che consente all'app di controllare su quale esecuzione viene eseguita la funzione.
    • API Preview.setOnPreviewOutputUpdateListener(). Se l'executor non è presente per quella funzione, viene eseguito nel thread principale.
    • Preview.setOnPreviewOutputUpdateListener
    • FocusMeteringAction.Builder.setAutoFocusCallback
    • ImageAnalysis.setAnalyzer
    • ImageCapture.takePicture
    • CameraView.takePicture
    • CameraView.startRecording
    • VideoCapture.startRecording

CameraInfo aggiunta con le API di controllo Flash Disponibile e Sensor Rotazione

  • Sono stati aggiunti CameraInfo e un metodo getCameraInfo, che consente alle app di controllare se è disponibile un obiettivo rivolto verso la fotocamera e se è disponibile un flash sulla fotocamera. Ad esempio:

    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);
    }
    
  • Membri aggiunti: CameraInfo.getSensorRotationDegrees() Fornisce l'orientamento del sensore della fotocamera rispetto all'orientamento naturale del dispositivo o, per comodità, rispetto a un orientamento descritto da una rotazione della superficie (che descrive un orientamento rispetto all'orientamento naturale).

Modifiche alle API e correzioni di bug

  • Proporzioni: per ogni caso d'uso, le applicazioni devono chiamare solo uno tra setTargetResolution() o setTargetAspectRatio(). Se li chiami entrambi nello stesso generatore, viene restituito un errore.
    • In generale, è consigliabile utilizzare setTargetAspectRatio() in base al design dell'interfaccia utente dell'applicazione. Le risoluzioni specifiche si basano sul caso d'uso. Ad esempio, l'anteprima è vicina alle risoluzioni dello schermo e l'acquisizione di immagini fornisce foto ad alta risoluzione. Per ulteriori informazioni, consulta la tabella delle risoluzioni automatiche.
    • Utilizza setTargetResolution() per casi più specifici, ad esempio quando sono richieste risoluzioni minime (per risparmiare risorse di calcolo) o massime (per i dettagli di elaborazione).
  • API Executor: è stata rimossa la chiamata setCallbackHandler() dalle API di configurazione dei casi d'uso. Le applicazioni possono invece impostare l'esecutore come parametro in varie altre API che impostano un callback.
  • Sono state aggiornate le annotazioni null per varie funzioni.
  • È stato risolto un problema che causava l'emissione di java.lang.IllegalStateException at Camera$StateCallback.onError all'apertura della fotocamera.
  • È stato risolto il problema relativo alla selezione di risoluzioni troppo piccole (inferiori a 640 x 480) quando l'app richiede risoluzioni più grandi o predefinite, con conseguente immagine di anteprima sgranata o sfocata. Le applicazioni che richiedono specificamente risoluzioni più piccole possono richiederle esplicitamente.
  • È stato risolto un problema per cui la videocamera mostrava uno schermo nero (errore di avvio della fotocamera non riuscito) dopo il ritorno da un intent che avviava un'altra applicazione della fotocamera.
  • È stato corretto un bug che generava il seguente errore quando le app vengono avviate o arrestate ripetutamente; java.lang.IllegalArgumentException: CaptureRequest contains unconfigured Input/Output Surface!
  • È stato corretto il seguente errore che si verificava durante la disattivazione dell'analisi delle immagini: java.lang.IllegalStateException: maxImages (4) has already been acquired, call #close before acquiring more.
  • Sono stati aggiunti ulteriori test per il flusso di disconnessione della videocamera.
  • Robustezza del sistema di test migliorata durante l'esecuzione di test consecutivi della fotocamera.

Camera-Camera2 e Camera-Core versione 1.0.0-alpha05

5 settembre 2019

androidx.camera:camera-camera2:1.0.0-alpha05 e androidx.camera:camera-core:1.0.0-alpha05 vengono rilasciati. Questi sono i commit inclusi in camera-camera2:1.0.0-alpha05 e questi sono i commit inclusi in camera-core:1.0.0-alpha05.

  • Modifica all'API: sono state rinominate le variabili di errore del caso d'uso:

    • ImageCapture.UseCaseError viene rinominato ImageCapture.ImageCaptureError
    • VideoCapture.UseCaseError viene rinominato VideoCapture.VideoCaptureError
  • Aggiunta dell'API CameraControl con API Tap-to-Focus

    • Aggiunta l'API per ottenere un CameraControl da CameraX per una fotocamera, selezionata in base all'obiettivo:

      CameraX.getCameraControl(LensFacing lensFacing)

    • Aggiunti MeteringPointFactory, MeteringPoint, MeteringMode e FocusMeteringAction per eseguire Tocco per mettere a fuoco:

      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();
      
    • È stata aggiunta l'API per CameraControl per avviare e annullare la misurazione della messa a fuoco:

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

    • Sono state aggiunte API per i Factory di punti di misurazione che aiutano a tradurre le coordinate dei tap in coordinate del sensore, in base alle classi di visualizzazione:

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

  • Imposta l'obbligo di chiamare i seguenti metodi nel thread principale (UI), generando un IllegalStateException se non lo sono. Le versioni future ne consentiranno l'utilizzo su altri thread e garantiranno la serializzazione.

    • CameraX.bindToLifecycle()
    • CameraX.unbind()
    • CameraX.unbindAll()
    • ImageAnalysis.setAnalyzer()
    • ImageAnalysis.getAnalyzer()
    • ImageAnalysis.removeAnalyzer()
    • Preview.removePreviewOutputListener()
    • Preview.getOnPreviewOutputUpdateListener()
    • Preview.setOnPreviewOutputUpdateListener()
  • Diverse impostazioni di configurazione ora accettano parametri null e i getter corrispondenti possono restituire null.

  • È stato risolto un problema durante i test su emulatori che non supportano le impostazioni AF/AE/AWB.

  • È stato corretto un bug di arresto anomalo durante la rotazione durante l'analisi dell'immagine.

  • È stato corretto un bug per cui l'anteprima risultava nera all'avvio (nessun dato della fotocamera), dopo la rotazione o il passaggio dalla fotocamera anteriore a quella posteriore e viceversa.

  • Sono stati rimossi i test per più casi d'uso di analisi delle immagini in contemporanea. Per garantire la compatibilità, le applicazioni devono allegare un solo caso d'uso di analisi delle immagini.

  • Sono stati aggiunti i primi test robolectric per la videocamera falsa nella suite di test della videocamera (in corso di elaborazione).

  • Il test Camera2Inititalizer è stato rimosso in quanto la copertura non era chiara/ingannevole.

Camera-Camera2 e Camera-Core versione 1.0.0-alpha04

7 agosto 2019

androidx.camera:camera-camera2:1.0.0-alpha04 e androidx.camera:camera-core:1.0.0-alpha04 vengono rilasciati. La versione 1.0.0-alpha04 contiene questi commit.

Nuove funzionalità

Modifiche alle proporzioni e alla selezione della risoluzione

Lo scopo di CameraX è inizializzare correttamente una sessione della fotocamera. Ciò significa che CameraX scende a compromessi in termini di risoluzione/rapporto aspetto in base alle funzionalità del dispositivo, per avviare una sessione di acquisizione come primo obiettivo, pertanto le richieste esatte potrebbero non essere soddisfatte. Questo può essere dovuto a:

  • I dispositivi non supportano la risoluzione richiesta
  • Problemi di compatibilità, ad esempio su dispositivi LEGACY in cui è necessario utilizzare determinate risoluzioni per il funzionamento corretto
  • Su alcuni dispositivi, alcuni formati sono disponibili solo con alcune proporzioni
  • Una preferenza per la "mod16 più vicina" per la codifica JPEG o video. Vedi CameraCharacteristics#SCALER_STREAM_CONFIGURATION_MAP

Anche se CameraX crea e gestisce la sessione, devi sempre controllare le dimensioni delle immagini restituite nell'output del caso d'uso nel codice e modificarle di conseguenza.

Sono state apportate alcune modifiche all'impostazione di risoluzioni e proporzioni con l'obiettivo di rendere l'API più chiara:

  • Ora il caso d'uso di anteprima è considerato avere proporzioni predefinite di 4:3 se non ne sono impostate.
  • Quando CameraX prende in considerazione internamente le modifiche alle risoluzioni e alle proporzioni richieste in base alle funzionalità del dispositivo, innanzitutto tenta di mantenere le stesse proporzioni (come stabilito da una delle chiamate setTargetAspectRatio o setTargetResolution).
  • Una versione "Nearest mod16" della risoluzione è considerata la stessa proporzione.

Modalità non bloccante di ImageAnalysis

  • Il comportamento di ImageReaderMode.ACQUIRE_LATEST_IMAGE ora non è bloccante. Acquisisce l'ultima immagine in coda, ma scarta continuamente le immagini inutilizzate per consentire alla pipeline della fotocamera di evitare blocchi.
  • L'analizzatore può conservare una singola immagine a tempo indeterminato senza bloccare la pipeline.
  • Se l'applicazione fornisce un'istruzione che si blocca, il caso d'uso ImageAnalysis si blocca.
  • L'esecutore predefinito impostato internamente si comporta come un esecutore non bloccante.

Correzioni di bug

  • Sono stati risolti i problemi di timeout in attesa della convergenza 3A durante l'acquisizione di immagini su dispositivi senza autofocus, esposizione automatica e bilanciamento del bianco automatico
  • È stato risolto il problema relativo allo scatto di foto rapide con ImageCapture. Corregge l'errore: java.lang.IllegalStateException: maxImages (2) has already been acquired
  • È stato risolto un problema per cui setLensFacing non veniva chiamato per un caso d'uso, con conseguente java.lang.IllegalArgumentException: Unable to get camera ID for use case.
  • È stato risolto il problema per cui il dispositivo LEGACY richiedeva proporzioni specifiche come risoluzione JPEG massima
  • È stato risolto un problema che si verificava quando l'app veniva messa in background durante l'apertura della fotocamera
  • È stato risolto un problema relativo all'API precedente alla versione 25, rimuovendo l'errore checkAndUpdateEglState: invalid current EGLDisplay
  • È stato risolto il problema relativo allo scollegamento dell'anteprima dopo l'attivazione e l'avvio delle estensioni
  • Gli elementi di compilazione per camera-view e camera-extensions vengono ora pubblicati come versioni alpha

Camera-Camera2 e Camera-Core versione 1.0.0-alpha03

2 luglio 2019

Vengono rilasciate le versioni androidx.camera:camera-core:1.0.0-alpha03 e androidx.camera:camera-camera2:1.0.0-alpha03. La versione 1.0.0-alpha03 contiene questi commit.

Modifiche alle API

  • È stato aggiunto un chiarimento javadoc per "target" nelle chiamate di configurazione di setTarget

Core della fotocamera

  • È stato corretto un arresto anomalo della superficie di input/output non configurata in caso di apertura/chiusura o associazione/disassociazione rapida
  • Passare alle nuove implementazioni dei futures
  • Correzioni dei test per test più affidabili
  • Il test di integrazione di base ora mostra l'ora di acquisizione delle foto
  • È stato sviluppato un'apposita classe di compatibilità interna per gli esecutori
  • L'app di test del tempo di acquisizione delle immagini attende il completamento della precedente e migliora la stabilità

Estensioni

  • Sono stati aggiunti controlli di versionamento
  • Copertura di test aggiuntiva: callback degli eventi di estensione
  • Miglioramenti per immagini e metadati corrispondenti internamente
  • Correzioni al passaggio di modalità nell'app di test

Camera-Camera2 e Camera-Core versione 1.0.0-alpha02

5 giugno 2019

androidx.camera:camera-core:1.0.0-alpha02 e androidx.camera:camera-camera2:1.0.0-alpha02 vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.

Correzioni di bug

  • È stato risolto il problema div per zero durante l'utilizzo dell'emulatore
  • È stato corretto l'errore NullPointerException/Surface Abandoned che si verificava su alcuni dispositivi quando si scattavano foto rapidamente scollegando e ricollegando rapidamente i casi d'uso.
  • È stato risolto un problema interno per garantire che gli aggiornamenti delle richieste di acquisizione influiscano in modo coerente su tutte le piattaforme
  • Miglioramenti alla stabilità al riavvio dei casi d'uso nelle nuove istanze di app
  • Modifiche all'architettura interna per prepararsi a supportare gli esecutori nell'API
  • Ulteriori chiarimenti Javadoc sulla classe CameraX e sulla gestione del ciclo di vita
  • Sono stati aggiunti i test con strumenti per l'app di test delle prestazioni Antelope
  • Rimozione di "-keepattributes Signature" nella configurazione dell'app ProGuard

Camera-Camera2 e Camera-Core 1.0.0-alpha01

7 maggio 2019

androidx.camera:camera-core:1.0.0-alpha01 e androidx.camera:camera-camera2:1.0.0-alpha01 vengono rilasciati. La versione 1.0.0-alpha01 contiene questi commit.

Camera-Lifecycle Version 1.0.0-beta11

14 ottobre 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-beta11. La versione 1.0.0-beta11 contiene questi commit.

Correzioni di bug

  • <UseCase>.getTargetRotation() restituirà Surface.ROTATION_0 se viene chiamato prima di essere associato a un'istanza Camera, a meno che non sia stata impostata una rotationTarget su Builder o UseCase. (I80fcd)

Camera-Lifecycle versione 1.0.0-beta10

23 settembre 2020

androidx.camera:camera-lifecycle:1.0.0-beta10 viene rilasciato. La versione 1.0.0-beta10 contiene questi commit.

Correzioni di bug

Versione del ciclo di vita della videocamera 1.0.0-beta09

16 settembre 2020

androidx.camera:camera-lifecycle:1.0.0-beta09 viene rilasciato. La versione 1.0.0-beta09 contiene questi commit.

Camera-Lifecycle versione 1.0.0-beta08

19 agosto 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-beta08. La versione 1.0.0-beta08 contiene questi commit.

Correzioni di bug

  • L'inizializzazione non dovrebbe più arrestarsi in modo anomalo quando si utilizza un contesto che non restituisce un oggetto Application da Context.getApplicationContext(). (I3d3c9, b/160817073)

Camera-Lifecycle versione 1.0.0-beta07

22 luglio 2020

androidx.camera:camera-lifecycle:1.0.0-beta07 viene rilasciato. La versione 1.0.0-beta07 contiene questi commit.

Camera-Lifecycle versione 1.0.0-beta06

24 giugno 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-beta06. La versione 1.0.0-beta06 contiene questi commit.

Modifiche all'API

  • CameraX può ora essere configurata con ProcessCameraProvider#configureInstance() prima di chiamare ProcessCameraProvider#getInstance(). Ciò consente la personalizzazione di CameraXConfig senza richiedere l'implementazione di CameraXConfig.Provider nella classe Application dell'app. (Ia1a8d).

Camera-Lifecycle versione 1.0.0-beta05

10 giugno 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-beta05. La versione 1.0.0-beta05 contiene questi commit.

Correzioni di bug

  • Correzione dell'arresto anomalo all'avvio dell'app durante l'inizializzazione di CameraX quando lo smartphone è in modalità Non disturbare. Un'istruzione InitializationException contiene un valore CameraUnavailableException che verrà impostato su ListenableFuture del risultato dell'inizializzazione anziché causare l'arresto anomalo dell'applicazione. (I9909a, b/149413835)

Camera-Lifecycle Versione 1.0.0-beta04

27 maggio 2020

androidx.camera:camera-lifecycle:1.0.0-beta04 viene rilasciato. La versione 1.0.0-beta04 contiene questi commit.

Camera-Lifecycle Versione 1.0.0-beta03

15 aprile 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-beta03. La versione 1.0.0-beta03 contiene questi commit.

Correzioni di bug

  • È stata corretta la regressione dalla versione beta03 in cui la chiamata a bindToLifecycle() con zero UseCase provocava un'eccezione. Questo ha impedito il recupero di un Camera senza associare un UseCase.
  • Correzioni per supportare il rilascio di camera-core

Camera-Lifecycle Versione 1.0.0-beta01

26 febbraio 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-beta01. La versione 1.0.0-beta01 contiene questi commit.

Correzioni di bug

  • È stata corretta la documentazione per indicare che, quando si ottiene un ProcessCameraProvider durante l'inizializzazione, viene utilizzata una configurazione predefinita e che l'estensione di Application è facoltativa. (I5e395)

Camera-Lifecycle versione 1.0.0-beta02

1° aprile 2020

androidx.camera:camera-lifecycle:1.0.0-beta02 viene rilasciato. La versione 1.0.0-beta02 contiene questi commit.

Correzioni di bug

  • Aggiornamento per supportare le correzioni di bug negli elementi camera-camera2:1.0.0-beta02 e camera-core:1.0.0-beta02.

Camera-Lifecycle Versione 1.0.0-alpha10

10 febbraio 2020

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-alpha10. La versione 1.0.0-alpha10 contiene questi commit.

Modifiche all'API

  • È stata aggiunta l'annotazione @MainThread ai metodi BindToLifecycle, unbind e unbindAll. (I990d2)

Camera-Lifecycle versione 1.0.0-alpha03

22 gennaio 2020

androidx.camera:camera-lifecycle:1.0.0-alpha03 viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.

regolari

  • Vari fix e aggiornamenti per supportare le modifiche di Camera Core e Camera2.

Versione Camera-Lifecycle 1.0.0-alpha02

18 dicembre 2019

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-alpha02. La versione 1.0.0-alpha02 contiene questi commit.

Modifiche alle dipendenze

  • Aggiornamento per l'utilizzo di androidx.camera:camera-core:1.0.0-alpha08.

Camera-Lifecycle versione 1.0.0-alpha01

4 dicembre 2019

Viene rilasciato androidx.camera:camera-lifecycle:1.0.0-alpha01. La versione 1.0.0-alpha01 di camera-lifecycle contiene questi commit

Note sull'API

  • Viene aggiunto l'elemento camera-lifecycle, che fornisce l'interfaccia LifeCycleCameraProvider e un'implementazione chiamata ProcessCameraProvider che fornisce molte delle funzioni della precedente classe CameraX nel nucleo e viene ottenuta tramite un metodo getInstance().
  • Le app devono includere la libreria camera-lifecycle per utilizzare CameraX.
  • Consulta le note nella sezione camera-core per scoprire come eseguire l'inizializzazione di CameraX utilizzando un ProcessCameraProvider.

Estensioni della fotocamera e Visualizzazione della fotocamera versione 1.0.0

Versione 1.0.0-alpha32

15 dicembre 2021

androidx.camera:camera-extensions:1.0.0-alpha32 e androidx.camera:camera-view:1.0.0-alpha32 vengono rilasciati. La versione 1.0.0-alpha32 contiene questi commit.

Modifiche all'API

  • Sono state rimosse le annotazioni @RequiresApi(21) non necessarie dalle classi/interfacce interne. (I8e286, b/204917951)
  • Aggiorna i file API per l'elemento camera-extensions. (If683a, b/161377155)

Correzioni di bug

  • Non consentire all'app di attivare le modalità di estensione durante l'associazione di VideoCapture. Le estensioni CameraX supportano solo ImageCapture e Preview. VideoCapture non è ancora supportato. Se l'app esegue il binding di VideoCapture e abilita qualsiasi modalità di estensione, verrà generato un IllegalArgumentException. (I0d87b)
  • CameraSelector#filter non genera più IllegalArgumentException quando il set di risultati è vuoto. (I27804)
  • L'API ExtensionsManager#getInstance è stata rinominata getInstanceAsync perché restituisce ListenableFuture. Il suffisso Async del nome della funzione può indicare chiaramente che si tratta di una funzione asincrona. (I279d2)
  • Rimuovi il parametro di risoluzione dall'API ExtensionsManager#getEstimatedCaptureLatencyRange, poiché gli utenti non possono sapere quali dimensioni sono supportate per il caso d'uso ImageCapture e non possono distinguere se le informazioni sulla latenza restituite si riferiscono alle dimensioni massime dell'output di acquisizione o al parametro di risoluzione di input. (I74bb2)
  • Sposta il parametro CameraProvider delle funzioni ExtensionsManager nell'API getInstance(). In questo modo, gli utenti non devono inserire il parametro CameraProvider ogni volta che chiamano le funzioni ExtensionsManager. (Ic7e48).

Versione 1.0.0-alpha31

17 novembre 2021

androidx.camera:camera-extensions:1.0.0-alpha31 e androidx.camera:camera-view:1.0.0-alpha31 vengono rilasciati. La versione 1.0.0-alpha31 contiene questi commit.

Modifiche all'API

  • È stato aggiunto CameraSelector#filter all'API pubblica per filtrare un elenco di CameraInfo in base a un CameraSelector. (I105d0)

Correzioni di bug

  • È stato corretto un arresto anomalo durante il passaggio rapido dalla modalità Estensioni su alcuni dispositivi. (Iebbef)

Versione 1.0.0-alpha30

13 ottobre 2021

androidx.camera:camera-extensions:1.0.0-alpha30 e androidx.camera:camera-view:1.0.0-alpha30 vengono rilasciati. La versione 1.0.0-alpha30 contiene questi commit.

Modifiche all'API

  • È stata aggiunta l'annotazione @RequestsApi(21) a tutte le classi CameraX e viene eliminato minSdkVersion da AndroidManifest.xml. In questo modo, camera-core potrà essere facilmente integrato nelle applicazioni con un minSdkVersion inferiore a 21, ma che vogliono utilizzare in modo condizionale i percorsi di codice che si basano sull'API 21 e versioni successive. Per qualsiasi applicazione con minSdkVersion 21 o versioni successive, questa modifica non richiede alcuna azione. (Ie7f2e, b/200599470)

Correzioni di bug

  • È stato risolto il problema AbstractMethodError che si verifica quando ProGuard è abilitato. (Iae468, b/201177844)

Versione 1.0.0-alpha29

29 settembre 2021

Vengono rilasciate le versioni androidx.camera:camera-extensions:1.0.0-alpha29 e androidx.camera:camera-view:1.0.0-alpha29. La versione 1.0.0-alpha29 contiene questi commit.

Modifiche all'API

  • L'annotazione ExperimentalUseCaseGroup è stata rimossa ora che le API non sono più sperimentali. (I01ef5)
  • rimuovi RotationProvider#removeAllListeners(). Usa invece il criterio RotationProvider#removeListener(...). (Id9d4a)
  • Aggiornamento della classe RotazioneReceiver: Listener set/clear modificato in add/remove/removeAll, variante setListener che utilizza il thread principale per impostazione predefinita e annotazione dei metodi aggiunta. (Ib1669)

Correzioni di bug

  • È stato rinominato ExtensionMode#BEAUTY in FACE_RETOUCH per presentare correttamente ciò che viene fatto dalla modalità di estensione. (I61f54, b/198515274)
  • È stato risolto il problema di chiusura imprevista della fotocamera quando più CameraController e PreviewView vengono utilizzati in un'unica attività. (Ibfd18, b/197539358)

Versione 1.0.0-alpha28

18 agosto 2021

androidx.camera:camera-extensions:1.0.0-alpha28 e androidx.camera:camera-view:1.0.0-alpha28 vengono rilasciati. La versione 1.0.0-alpha28 contiene questi commit.

Modifiche all'API

  • L'annotazione ExperimentalUseCaseGroupLifecycle è stata rimossa ora che le API non sono più sperimentali. (I17b85)
  • ha eseguito il refactoring di RotazioneListener e lo ha rinominato in RotazioneProvider. Continua a fornire la stessa funzionalità con un'API leggermente diversa. (Idffc5)
  • Rinomina TAP_TO_FOCUS_UNSUCCESSFUL in TAP_TO_FOCUS_NOT_FOCUSED e TAP_TO_FOCUS_SUCCESSFUL in TAP_TO_FOCUS_FOCUSED. OutputSize è stato impostato come valore finale (I099fa)

Correzioni di bug

  • Rimosse le classi <EffectName><UseCase>Extender deprecate, ExtensionsErrorListener e le API ExtensionsManager correlate. (I3b8c3).

Versione 1.0.0-alpha27

21 luglio 2021

androidx.camera:camera-extensions:1.0.0-alpha27 e androidx.camera:camera-view:1.0.0-alpha27 vengono rilasciati. La versione 1.0.0-alpha27 contiene questi commit.

Modifiche alle API

  • L'API Viewport non è più sperimentale. Rimuovi l'annotazione sperimentale dell'API. (I717ea)
  • Rinomina di CoordinateTransform#getTransform in CoordinateTransform#transform e aggiornamento della documentazione JavaDoc (I864ae)

Correzioni di bug

  • È stato risolto il problema di allungamento della modalità PreviewView PERFORMANCE quando viene utilizzata insieme all'interfaccia utente di Scrivi. (Ie1137, b/183864890)

Versione 1.0.0-alpha26

30 giugno 2021

androidx.camera:camera-extensions:1.0.0-alpha26 e androidx.camera:camera-view:1.0.0-alpha26 vengono rilasciati. La versione 1.0.0-alpha26 contiene questi commit.

Modifiche all'API

  • Aggiungi un nuovo metodo CameraController#getTapToFocusState() che esponga l'ultimo risultato di tocco per mettere a fuoco. (Iaccb0)
  • aggiunta di altre funzionalità di base della fotocamera a CameraController: getter/setter per formato dell'inquadratura target, risoluzione target, modalità di acquisizione, CameraControl ed esecutori personalizzati. (Iea8f2)
  • Aggiungi una classe RotationReceiver che riceve le modifiche alla rotazione del Surface. Può essere utilizzato per impostare la rotazione target quando il dispositivo è in modalità verticale/orizzontale fissa. (Ib278f)
  • Sono state esposte nuove API pubbliche getEstimatedCaptureLatencyRange nella classe ExtensionsManager. (I6a8ec)
  • È stato ritirato ExtensionsErrorListener. Al momento, questa interfaccia viene utilizzata solo per monitorare se manca un'anteprima o un'acquisizione di immagini quando vengono attivate le modalità di estensione. CameraX aggiungerà automaticamente un'altra istanza di Preview o ImageCapture per garantire il corretto funzionamento delle funzioni di estensione. Dopodiché, non verrà segnalato alcun errore tramite questa interfaccia. (I47d9e)
  • Sono state esposte le nuove API pubbliche getInstance, isDisplayAvailable e getEstensioneEnabledCameraSelector e vecchie classi <EffectName><UseCase>Extender deprecate e API correlate. (I329e6)

Versione 1.0.0-alpha25

2 giugno 2021

androidx.camera:camera-extensions:1.0.0-alpha25 e androidx.camera:camera-view:1.0.0-alpha25 vengono rilasciati. La versione 1.0.0-alpha25 contiene questi commit.

Modifiche all'API

  • Le API ExperimentalCameraFilter non sono più sperimentali e diventano API formali. Possono essere utilizzati senza attivazione annotata. (I4bc94)
  • Aggiungi un'utilità che trasformi le coordinate tra i casi d'uso. Esempio di utilizzo: trasformazione delle coordinate rilevate nel caso d'uso ImageAnalysis ed evidenziazione dell'oggetto rilevato nell'anteprima. (I63ab1, b/137515129)
  • CameraView rimosso. CameraView è stato sostituito da CameraController. Per informazioni su come eseguire la migrazione, consulta la guida alla migrazione. (Id5005)

Correzioni di bug

  • ExperimentalUseCaseGroupLifecycle sostituito con ExperimentalUseCaseGroup. (I3b2ef, b/159033688)

Versione 1.0.0-alpha24

21 aprile 2021

androidx.camera:camera-extensions:1.0.0-alpha24 e androidx.camera:camera-view:1.0.0-alpha24 vengono rilasciati. La versione 1.0.0-alpha24 contiene questi commit.

Correzioni di bug

  • L'annotazione @Experimental è stata sostituita con @RequiresOptIn nelle API sperimentali. Per chiamare le API sperimentali, utilizza androidx.annotation.OptIn anziché androidx.annotation.experimental.UseExperimental deprecato. (Iff226)
  • È stato risolto il problema di allungamento di PreviewView su Samsung J5 Prime (Ib10b6)

Estensioni della fotocamera e visualizzazione versione 1.0.0-alpha23

24 marzo 2021

Vengono rilasciate le versioni androidx.camera:camera-extensions:1.0.0-alpha23 e androidx.camera:camera-view:1.0.0-alpha23. La versione 1.0.0-alpha23 contiene questi commit.

Modifiche all'API

  • CameraView verrà ritirata. Usa invece il criterio LifecycleCameraController. Consulta la guida alla migrazione (Idac2c)
  • È stata aggiunta l'annotazione FloatRange a setLinearZoom() (I69971)

Correzioni di bug

  • Le dipendenze della visualizzazione della videocamera bloccate devono fare affidamento sugli elementi 1.0.0. La dipendenza da camera-view non causerà più la risoluzione delle dipendenze di Gradle per eseguire automaticamente l'upgrade di camera-core, camera-camera2 e camera-lifecycle alle ultime versioni 1.1.0 degli elementi, anche se camera-view è ancora compatibile con questi elementi se sono impostati esplicitamente per utilizzare la versione 1.1.0. (Ic8fa1, b/181599852)
  • È stata corretta l'anteprima allungata del Samsung A3 in PreviewView. (Iacb30, b/180121821)
  • È stato risolto il problema per cui il selettore della videocamera non può essere impostato prima dell'inizializzazione della videocamera. (Ic8bd0)

Estensioni della fotocamera e visualizzazione versione 1.0.0-alpha22

24 febbraio 2021

androidx.camera:camera-extensions:1.0.0-alpha22 e androidx.camera:camera-view:1.0.0-alpha22 vengono rilasciati. La versione 1.0.0-alpha22 contiene questi commit.

Modifiche all'API

Correzioni di bug

  • È stato corretto ExtensionsErrorListener per segnalare gli errori quando sono associati solo Anteprima o ImageCapture. (I5ae39)

Estensioni e visualizzazione della videocamera, versione 1.0.0-alpha21

27 gennaio 2021

Vengono rilasciate le versioni androidx.camera:camera-extensions:1.0.0-alpha21 e androidx.camera:camera-view:1.0.0-alpha21. La versione 1.0.0-alpha21 contiene questi commit.

Rilascio in corso per supportare altri elementi della raccolta delle fotocamere.

Estensioni della videocamera e visualizzazione, versione 1.0.0-alpha20

16 dicembre 2020

androidx.camera:camera-extensions:1.0.0-alpha20 e androidx.camera:camera-view:1.0.0-alpha20 vengono rilasciati. La versione 1.0.0-alpha20 contiene questi commit.

Rilasciata per supportare altri elementi della raccolta di fotocamere.

Estensioni della fotocamera e Visualizzazione della fotocamera versione 1.0.0-alpha19

11 novembre 2020

Vengono rilasciate le versioni androidx.camera:camera-extensions:1.0.0-alpha19 e androidx.camera:camera-view:1.0.0-alpha19. La versione 1.0.0-alpha19 contiene questi commit.

Correzioni di bug

  • L'annotazione @ExperimentalVideo è stata introdotta nella visualizzazione della fotocamera. Questa annotazione indica le API che espongono funzionalità video sperimentali, che sono soggette a modifiche man mano che le funzionalità vengono sviluppate completamente. Qualsiasi metodo che utilizza queste API deve utilizzare l'annotazione @UseExperimental con ExperimentalVideo come markerClass. (I6d729)

Camera-Extensions versione 1.0.0-alpha18

14 ottobre 2020

Viene rilasciato androidx.camera:camera-extensions:1.0.0-alpha18. La versione 1.0.0-alpha18 contiene questi commit.

Correzioni di bug

  • È stata migliorata la latenza dell'inizializzazione di CameraX e bindToLifecycle (I61dc5)
  • <UseCase>.getTargetRotation() restituirà Surface.ROTATION_0 se chiamato prima di essere collegato a un'istanza Camera, a meno che non sia stata impostata una rotazione target in Builder o nel caso d'uso. (I80fcd)

Versione Camera-View 1.0.0-alpha18

14 ottobre 2020

androidx.camera:camera-view:1.0.0-alpha18 viene rilasciato. La versione 1.0.0-alpha18 contiene questi commit.

Rilasciata per supportare altri elementi della raccolta di fotocamere.

Camera-Extensions versione 1.0.0-alpha17

23 settembre 2020

Viene rilasciato androidx.camera:camera-extensions:1.0.0-alpha17. La versione 1.0.0-alpha17 contiene questi commit.

Correzioni di bug

Versione Camera-View 1.0.0-alpha17

23 settembre 2020

androidx.camera:camera-view:1.0.0-alpha17 viene rilasciato. La versione 1.0.0-alpha17 contiene questi commit.

Correzioni di bug

Estensioni della fotocamera versione 1.0.0-alpha16

16 settembre 2020

androidx.camera:camera-extensions:1.0.0-alpha16 viene rilasciato. La versione 1.0.0-alpha16 contiene questi commit.

Correzioni di bug

  • È stato aggiunto un metodo in ExtensionsManager per ottenere un oggetto Extensions che viene utilizzato per attivare ed eseguire query sulle estensioni nelle istanze di Camera (I4fb7e)

Camera-View versione 1.0.0-alpha16

16 settembre 2020

androidx.camera:camera-view:1.0.0-alpha16 viene rilasciato. La versione 1.0.0-alpha16 contiene questi commit.

Modifiche all'API

  • PreviewView#setDeviceRotationForRemoteDisplayMode() e PreviewView#getDeviceRotationForRemoteDisplayMode() sono stati rimossi. I due metodi sono per personalizzare la rotazione dell'anteprima, quando la rotazione desiderata non è la rotazione del display, ad esempio il display remoto. Per gestire la rotazione dell'anteprima non in visualizzazione, imposta la rotazione desiderata con Preview#setTargetRotation() e il nuovo PreviewView#getViewPort(targetRotation) aggiunto. (Ib62cc)
  • createSurfaceProvider() rinominato in getSurfaceProvider(). Il metodo restituirà sempre la stessa istanza di Preview.SurfaceProvider. (Iff83c)

Correzioni di bug

  • Forza PreviewView a utilizzare TextureView se l'effetto di estensione è attivato e l'implementazione della libreria del fornitore deve eseguire una procedura speciale sulla superficie di output. (I0c3cc)
  • Consenti la rotazione arbitraria del target per l'anteprima. Le informazioni sulla trasformazione vengono calcolate e restituite all'utente in tempo reale tramite un nuovo callback TranformationInfoListener. (I21470)

Problemi noti

  • In PreviewView, OnClickListener#onClick() non viene invocato quando l'utente finale fa clic su PreviewView. L'evento tocco viene utilizzato per errore da PreviewView#onTouchEvent(). Il problema verrà risolto nella prossima release.
  • Il punto di misurazione ottenuto da PreviewView#getMeteringPointFactory() potrebbe essere errato se ViewPort viene utilizzato con PreviewView.

Camera-Extensions versione 1.0.0-alpha15

19 agosto 2020

Viene rilasciato androidx.camera:camera-extensions:1.0.0-alpha15. La versione 1.0.0-alpha15 contiene questi commit.

Correzioni di bug

  • Il metodo ExtensionsManager.init() ora utilizza un contesto come parametro, invece di avere 0 argomenti. (Ife754)
  • L'inizializzazione non dovrebbe più arrestarsi in modo anomalo quando si utilizza un contesto che non restituisce un oggetto Application da Context.getApplicationContext(). (I3d3c9, b/160817073)

    Versione Camera-View 1.0.0-alpha15

    19 agosto 2020

Viene rilasciato androidx.camera:camera-view:1.0.0-alpha15. La versione 1.0.0-alpha15 contiene questi commit.

Correzioni di bug

  • DisplayOrientedMeteringPointFactory accetta un'istanza CameraInfo instead of a CameraSelector, quindi esiste una mappatura diretta per la Camera per la quale la factory genererà i punti. Tutti i corsi che utilizzano DisplayOrientedMeteringPointFactory prendono anche un'istanza CameraInfo anziché CameraSelector. (I400c1)
  • TextureViewMeteringPointFactory rimosso. PreviewView fornisce un'API pubblica (createMeteringPointFactory()) per creare una factory di punti di misurazione, indipendentemente dall'utilizzo di TextureView o SurfaceView. (Ide693)
  • Rinomina le modalità di implementazione SURFACE_VIEW/TEXTURE_VIEW di PreviewView in PERFORMANCE/COMPATIBLE. PERFORMANCE è la vecchia modalità SURFACE_VIEW e COMPATIBLE è la vecchia modalità TEXTURE_VIEW. (I0edc2)
  • Per l'acquisizione di immagini, sovrascrivi il flag di rotazione orizzontale nei metadati in base alla direzione della fotocamera. (I28499)

Estensioni-videocamera versione 1.0.0-alpha14

22 luglio 2020

androidx.camera:camera-extensions:1.0.0-alpha14 viene rilasciato. La versione 1.0.0-alpha14 contiene questi commit.

Versione Camera-View 1.0.0-alpha14

22 luglio 2020

Viene rilasciato androidx.camera:camera-view:1.0.0-alpha14. La versione 1.0.0-alpha14 contiene questi commit.

Estensioni della fotocamera versione 1.0.0-alpha13

24 giugno 2020

androidx.camera:camera-extensions:1.0.0-alpha13 viene rilasciato. La versione 1.0.0-alpha13 contiene questi commit.

Correzioni di bug

  • Sono state aggiunte interfacce sperimentali per filtrare le videocamere in base all'ID e alle caratteristiche della videocamera. (I28f61)

Camera-View versione 1.0.0-alpha13

24 giugno 2020

androidx.camera:camera-view:1.0.0-alpha13 viene rilasciato. La versione 1.0.0-alpha13 contiene questi commit.

Correzioni di bug

  • CameraView non si arresta più in modo anomalo con un'eccezione illegaleArgumentException durante l'associazione a un LifecycleOwner il cui ciclo di vita passa a uno stato DESTROYED poco dopo essere stato associato. I cicli di vita di Binding in stato DESTROYED non tenteranno di aprire la videocamera. (I7c2b8)
  • StreamState di PreviewView è ora disponibile tramite CameraView.getPreviewStreamState() (I21a2b)

Estensioni della videocamera versione 1.0.0-alpha12

10 giugno 2020

androidx.camera:camera-extensions:1.0.0-alpha12 viene rilasciato. La versione 1.0.0-alpha12 contiene questi commit.

Correzioni di bug

  • È stato risolto l'arresto anomalo all'avvio dell'app durante l'inizializzazione di CameraX mentre il telefono è in modalità Non disturbare. Un InitializationException contenente un CameraUnavailableException verrà impostato sul ListenableFuture del risultato dell'inizializzazione anziché arrestare in modo anomalo l'applicazione. (I9909a, b/149413835)

Versione Camera-View 1.0.0-alpha12

10 giugno 2020

androidx.camera:camera-view:1.0.0-alpha12 viene rilasciato. La versione 1.0.0-alpha12 contiene questi commit.

Correzioni di bug

  • Aggiungi l'API PreviewView#getBitmap() che restituisce una rappresentazione bitmap dei contenuti visualizzati sulla piattaforma di anteprima. (I9b500, b/157659818)

Estensioni per fotocamera versione 1.0.0-alpha11

27 maggio 2020

androidx.camera:camera-extensions:1.0.0-alpha11 viene rilasciato. La versione 1.0.0-alpha11 contiene questi commit.

Versione Camera-View 1.0.0-alpha12

10 giugno 2020

androidx.camera:camera-view:1.0.0-alpha12 viene rilasciato. La versione 1.0.0-alpha12 contiene questi commit.

Nuove funzionalità

Modifiche all'API

Correzioni di bug

  • Aggiungi l'API PreviewView#getBitmap() che restituisce una rappresentazione bitmap dei contenuti visualizzati sulla superficie di anteprima. (I9b500, b/157659818)

Camera-View Versione 1.0.0-alpha11

27 maggio 2020

androidx.camera:camera-view:1.0.0-alpha11 viene rilasciato. La versione 1.0.0-alpha11 contiene questi commit.

Modifiche all'API

  • Aggiungi l'API PreviewView#getPreviewStreamState che consente alle app di verificare se l'anteprima è in streaming o meno. Quando l'elemento PreviewView è in modalità TEXTURE_VIEW, lo stato STREAMING garantisce anche che l'immagine di anteprima sia visibile. (Ic0906, b/154652477)
  • È stata aggiunta l'API PreviewView#setDeviceRotationForRemoteDisplayMode() per fornire la rotazione del dispositivo per i calcoli di trasformazione se l'applicazione è in esecuzione in modalità di visualizzazione remota. (I59b95, b/153514525)

Correzioni di bug

  • È stato risolto il problema di distorsione dell'anteprima sulle videocamere FULL/LIMITED/LEVEL_3 con Android 7.0 e versioni precedenti. Utilizzo forzato della modalità ImplementationMode#TEXTURE_VIEW quando la versione di Android è 7.0 o precedente. (I83e30, b/155085307)
  • Il parametro CameraInfo è stato rimosso da PreviewView#createSurfaceProvider(), PreviewView ora lo recupera internamente da SurfaceRequest. (If18f0, b/154652477)
  • È stato corretto il formato video predefinito di VideoCapture in CameraView in modo che sia 16:9. (Ie6a7b, b/153237864)
  • Risolvere i problemi di schermo nero PreviewView quando si rimuove il frammento Preview e si torna indietro in ViewPager2. È stato risolto anche il problema quando removeView(previewview) e poi addView(previewView). (Iab555, b/149877652, b/147354615)
  • Aggiorna l'API CameraView#takePicture() per consentire il salvataggio delle immagini in Uri e OutputStream. Aggiorna l'app di test in modo da utilizzare Uri come esempio canonico. (Ia2459, b/153607583)
  • Puoi impostare il tipo di scala di PreviewView da un layout XML impostando l'attributo ScaleType. (I08565, b/153015659)
  • CameraView.ScaleType è stato rimosso. Utilizza invece PreviewView.ScaleType per impostare/ottenere un tipo di scala con CameraView. (Ia8974, b/153014831)
  • Assegna a PreviewView un colore di sfondo per impostazione predefinita, se non ne ha già uno. In questo modo, i contenuti dietro non saranno visibili prima dell'inizio dello stream di anteprima. (I09fad)

Estensioni della fotocamera, versione 1.0.0-alpha10

15 aprile 2020

Viene rilasciato androidx.camera:camera-extensions:1.0.0-alpha10. La versione 1.0.0-alpha10 contiene questi commit.

Correzioni di bug

  • Correzioni per supportare il rilascio di Camera-Core

Camera-View versione 1.0.0-alpha10

15 aprile 2020

androidx.camera:camera-view:1.0.0-alpha010 viene rilasciato. La versione 1.0.0-alpha010 contiene questi commit.

Correzioni di bug

  • È stato risolto un precedente problema noto per cui l'implementazione di SurfaceView di PreviewView non funzionava correttamente su alcuni dispositivi e causava l'arresto anomalo dell'app dopo la ripresa dell'anteprima. (I5ed6b)

Camera-Estensioni versione 1.0.0-alpha09

1° aprile 2020

androidx.camera:camera-extensions:1.0.0-alpha09 viene rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Correzioni di bug

  • Aggiornamento per supportare le correzioni di bug negli elementi camera-camera2:1.0.0-beta02, camera-core:1.0.0-beta02 e camera-lifecycle:1.0.0-beta02

Versione Camera-View 1.0.0-alpha09

1° aprile 2020 androidx.camera:camera-view:1.0.0-alpha09 viene rilasciato. La versione 1.0.0-alpha09 contiene questi commit.

Problemi noti

  • L'utilizzo di ImplementationMode.SURFACE_VIEW con PreviewView potrebbe non funzionare bene su alcuni dispositivi perché il SurfaceView usato per l'anteprima ne invalida la superficie quando il ciclo di vita della finestra in cui si trova viene interrotto, quando si riavvia, la fotocamera viene riaperta e potrebbe tentare di riprendere l'anteprima prima che la piattaforma SurfaceView sia di nuovo valida. Per ora, dovresti usare ImplementationMode.TEXTURE_VIEW.

Modifiche all'API

  • PreviewView.setImplementationMode() rinominato in PreviewView.setPreferredImplementationMode().
  • PreviewView.getImplementationMode() rinominato in PreviewView.getPreferredImplementationMode().
  • PreviewView.getSurfaceProvider() sostituito con PreviewView.createSurfaceProvider(CameraInfo), che accetta un'istanza CameraInfo nullable utilizzata per ottimizzare l'anteprima utilizzando ImplementationMode.SURFACE_VIEW, se possibile. Se viene passata un'istanza null o se imposti la modalità di implementazione preferita su ImplementationMode.TEXTURE_VIEW, viene utilizzato internamente ImplementationMode.TEXTURE_VIEW.
  • Il seguente esempio di codice mostra come un caso d'uso di anteprima veniva utilizzato in precedenza con PreviewView.

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

    Al momento puoi scrivere quanto segue:

    val camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector, preview)
    previewView.preferredImplementationMode = ImplementationMode.TEXTURE_VIEW
    preview.setSurfaceProvider(previewView.createSurfaceProvider(camera.cameraInfo))
    
  • L'annotazione @UiThread è stata aggiunta a PreviewView.getSurfaceProvider(), il che significa che deve essere chiamata dal thread principale. (I192f3)

  • È stato aggiunto PreviewView.setScaleType(), che consente di impostare il tipo di scala dell'anteprima. Accetta uno dei valori in PreviewView.ScaleType e il valore predefinito è PreviewView.ScaleType.FILL_CENTER.

  • PreviewView.getScaleType() aggiunto.

  • È stato rimosso il supporto per l'impostazione della modalità di implementazione di PreviewView in un layout XML utilizzando l'attributo implementationMode.

  • Aggiungi l'API createMeteringPointFactory() ad PreviewView per supportare la conversione (x, y) di PreviewView in MeteringPoint. (Ib36d7)

Correzioni di bug

  • Sono stati corretti i casi in cui viene visualizzata un'anteprima errata dopo la modifica delle dimensioni di PreviewView. (I71101)

Camera-Extensions versione 1.0.0-alpha08

26 febbraio 2020

Viene rilasciato androidx.camera:camera-extensions:1.0.0-alpha08. La versione 1.0.0-alpha08 contiene questi commit.

Camera-View versione 1.0.0-alpha08

26 febbraio 2020

Viene rilasciato androidx.camera:camera-view:1.0.0-alpha08. La versione 1.0.0-alpha08 contiene questi commit.

Correzioni di bug

  • ListenableFuture su SurfaceRequest.provideSurface() sostituito con Executor e Callback. In questo modo, l'API viene semplificata perché non richiede più la gestione delle eccezioni su provideSurface() e impone che il callback di provideSurface() non possa essere annullato. Questo serve a evitare arresti anomali sui dispositivi meno recenti causati dal rilascio prematuro delle piattaforme. L'oggetto SurfaceRequest.Result viene ora utilizzato per monitorare il modo in cui un SurfaceRequest utilizza il Surface fornito. (I7854b)
  • SurfaceRequest.setSurface(Surface) è stato rinominato in SurfaceRequest.provideSurface(Surface) e SurfaceRequest.setWillNotComplete() in SurfaceRequest.willNotProvideSurface(). (I224fe)
  • È stata corretta l'inizializzazione delle varianti dell'app con ProGuard abilitato preservando il flag che imposta il provider CameraXConfig predefinito. (I2d6c1).

Estensioni per fotocamera versione 1.0.0-alpha07

10 febbraio 2020

androidx.camera:camera-extensions:1.0.0-alpha07 viene rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Correzioni di bug

  • Gli argomenti che in precedenza venivano passati in ImageCapture.OnImageSavedCallback.onError() e ImageCapture.OnImageCapturedCallback.onError() sono stati sostituiti da un unico argomento ImageCaptureException, che contiene ancora tutte le informazioni passate in precedenza.
  • L'argomento file passato in precedenza in ImageCapture.OnImageSavedCallback.onImageSaved() è stato rimosso. (I750d2)

Camera-View versione 1.0.0-alpha07

10 febbraio 2020

androidx.camera:camera-view:1.0.0-alpha07 viene rilasciato. La versione 1.0.0-alpha07 contiene questi commit.

Modifiche all'API

  • L'implementazione di TextureView di PreviewView ora imposta le dimensioni di TextureView sulle dimensioni di output del sensore della fotocamera prima di ridimensionarlo per riempire il PreviewView principale. Se vuoi che l'anteprima della fotocamera riempia un'intera parte dell'interfaccia utente (ad esempio l'intero schermo), non devi impostare le dimensioni di PreviewView su un valore fisso né racchiuderne i contenuti (utilizzando l'attributo "wrap_content", ad esempio), l'anteprima della fotocamera potrebbe riempire solo una parte dell'PreviewView (se le dimensioni di output del sensore della videocamera sono inferiori). Devi invece impostare PreviewView come grande quanto l'elemento principale (ad esempio utilizzando l'attributo "match_parent"). (1204869)

Correzioni di bug

  • ImageCapture è stato aggiornato per consentire il salvataggio delle immagini in Uri e OutputStream. I metodi takePicture sovraccaricati sono stati combinati in un unico metodo. App di prova aggiornata in modo che utilizzi Uri come esempio canonico. (Ia3bec)
  • Preview.PreviewSurfaceProvider è stato rinominato in Preview.SurfaceProvider. SurfaceProvider non richiede più agli sviluppatori di creare il proprio ListenableFuture e la fornitura di un Surface ora avviene tramite un nuovo oggetto SurfaceRequest. Il metodo Preview.getPreviewSurfaceProvider() è stato rimosso a causa del potenziale uso improprio quando Preview è accoppiato ad altre classi come PreviewView. (I20105)
  • Gli argomenti che in precedenza venivano passati in ImageCapture.OnImageSavedCallback.onError() e ImageCapture.OnImageCapturedCallback.onError() sono stati sostituiti da un unico argomento ImageCaptureException, che contiene ancora tutte le informazioni passate in precedenza.
  • L'argomento del file passato in precedenza in ImageCapture.OnImageSavedCallback.onImageSaved() è stato rimosso. (I750d2)
  • L'API è stata aggiornata con l'unione dei metodi getZoomRatio(), getMaxZoomRatio(), getMinZoomRatio() e getLinearZoom() di CameraInfo in getZoomState(), che restituisce un'istanza ZoomState. (Ib19fe)

Camera-Extensions versione 1.0.0-alpha06

22 gennaio 2020

androidx.camera:camera-extensions:1.0.0-alpha06 viene rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

regolari

  • Vari fix e aggiornamenti per supportare le modifiche di Camera Core e Camera2.

Versione Camera-View 1.0.0-alpha06

22 gennaio 2020

androidx.camera:camera-view:1.0.0-alpha06 viene rilasciato. La versione 1.0.0-alpha06 contiene questi commit.

regolari

  • Vari fix e aggiornamenti per supportare le modifiche di Camera Core e Camera2.

Camera-Extensions versione 1.0.0-alpha05

18 dicembre 2019

androidx.camera:camera-extensions:1.0.0-alpha05 viene rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Correzioni di bug

  • Aggiornato in base alle API Camera Core interne.

Versione Camera-View 1.0.0-alpha05

18 dicembre 2019

androidx.camera:camera-view:1.0.0-alpha05 viene rilasciato. La versione 1.0.0-alpha05 contiene questi commit.

Problemi noti

  • Quando utilizzi PreviewView (b/146215202), le proporzioni potrebbero non essere corrette.

Nuove funzionalità

  • È stata implementata una nuova classe denominata PreviewView.TextureViewImplementation che sincronizza il ciclo di vita di SurfaceTexture con l'utilizzo della superficie di TextureView da parte della fotocamera.

Estensioni della fotocamera versione 1.0.0-alpha04

4 dicembre 2019

Viene rilasciato androidx.camera:camera-extensions:1.0.0-alpha04. La versione 1.0.0-alpha04 di camera-extensions contiene questi commit

Modifiche all'API

  • Per verificare la disponibilità e l'attivazione di un'estensione, ora viene utilizzato un CameraSelector come parametro di input. Deve essere lo stesso CameraSelector utilizzato per l'associazione del caso d'uso.

    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)
    
  • Devi inizializzare le estensioni prima di utilizzare la libreria delle estensioni.

    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()
    )
    

Versione Camera-View 1.0.0-alpha04

4 dicembre 2019

androidx.camera:camera-view:1.0.0-alpha04 viene rilasciato. La versione 1.0.0-alpha04 di camera-view contiene questi commit

Modifiche all'API

  • È fornita una classe PreviewView per visualizzare facilmente l'output del caso d'uso dell'anteprima in un'applicazione.
  • PreviewView può essere incluso nel layout:

    <androidx.camera.view.PreviewView
      android:id="@+id/preview_view"
      … />
    
  • PreviewView fornisce un PreviewSurfaceProvider per collegare facilmente un caso d'uso di Anteprima

    preview.setPreviewSurfaceProvider(previewView.previewSurfaceProvider)
    
  • "ZoomLevel" ora è "ZoomRatio" nella denominazione API

  • La nullabilità di alcuni parametri di metodo è cambiata

Estensioni della videocamera e Visualizzazione della videocamera versione 1.0.0-alpha03

9 ottobre 2019

androidx.camera:camera-extensions:1.0.0-alpha03 e androidx.camera:camera-view:1.0.0-alpha03 vengono rilasciati. Questi sono gli impegni inclusi in camera-extensions:1.0.0-alpha03 e gli impegni inclusi in camera-view:1.0.0-alpha03.

Nuove funzionalità

  • È stato aggiunto l'inizializzatore di contesto per le estensioni. Versione delle estensioni incrementata a 1.1.0

Estensioni della fotocamera e Visualizzazione della fotocamera versione 1.0.0-alpha02

5 settembre 2019

androidx.camera:camera-extensions:1.0.0-alpha02 e androidx.camera:camera-view:1.0.0-alpha02 vengono rilasciati. Questi sono i commit inclusi in camera-extensions:1.0.0-alpha02 e questi sono i commit inclusi camera-view:1.0.0-alpha02.

  • Sono stati aggiunti test per verificare che PreviewImageProcessorImpl abbia implementato correttamente i timestamp.
  • Correggi l'errore di test ExtensionTest su Nexus 5 (livello API 21) e assicurati che l'anteprima sia disponibile.

Estensioni della videocamera e Visualizzazione videocamera versione 1.0.0-alpha01

7 agosto 2019

androidx.camera:camera-extensions:1.0.0-alpha01 e androidx.camera:camera-view:1.0.0-alpha01 vengono rilasciati. Questi sono i commit inclusi in camera-extensions:1.0.0-alpha01 e questi sono i commit inclusi camera-view:1.0.0-alpha01

  • Nuova libreria per le future Estensioni della fotocamera per accedere agli effetti sui dispositivi supportati. Questa raccolta è ancora in fase di sviluppo.
  • Nuova classe di visualizzazione della videocamera. Questa raccolta è in fase di sviluppo.