相機觀景窗

  
獨立的可組合函式和以 View 為基礎的相機觀景窗

下表列出 androidx.camera-viewfinder 群組的所有構件。

構件 穩定版 候選版 Beta 版 Alpha 版
viewfinder-compose - - - 1.4.0-alpha11
viewfinder-core - - - 1.4.0-alpha11
viewfinder-view - - - 1.4.0-alpha11
本程式庫上次更新日期：2024 年 12 月 11 日

宣告依附元件

如要為 camera-viewfinder 新增依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    // Use to implement camera viewfinders
    
    implementation "androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10"
    implementation "androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10"
    implementation "androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10"

}

Kotlin

dependencies {
    // Use to implement camera viewfinders
    implementation("androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10")
    implementation("androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10")
    implementation("androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10")


}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

1.4 版

1.4.0-alpha11 版本

2024 年 12 月 11 日

發布 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha11、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha11 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha11。1.4.0-alpha11 版包含這些修訂項目。

API 變更

  • viewfinder-core 類別已移至與所屬程式庫一致的套件。(I431c6)。
  • CameraViewfinder.ScaleType 已移至 viewfinder-core，因此可與 Compose 一併重複使用 (I87ef1)
  • 已移除淘汰的 CameraViewfinder 類別。請使用提供等同功能的新 API。(I6e59a)

1.4.0-alpha10 版本

2024 年 10 月 30 日

發布 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha10、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha10 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha10。1.4.0-alpha10 版包含這些修訂項目。

1.4.0-alpha09 版本

2024 年 10 月 2 日

發布 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha09、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha09 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha09。1.4.0-alpha09 版包含這些修訂項目。

1.4.0-alpha08 版本

2024 年 9 月 4 日

發布 androidx.camera.viewfinder:viewfinder-compose:1.4.0-alpha08、androidx.camera.viewfinder:viewfinder-core:1.4.0-alpha08 和 androidx.camera.viewfinder:viewfinder-view:1.4.0-alpha08。1.4.0-alpha08 版包含這些修訂項目。

新功能

更新至 1.4.0-alpha08 後，CameraX 檢視器構件已移至專屬的程式庫群組。這項變更有助於提升 CameraX 程式庫的模組化和可維護性。

如果您先前依附 androidx.camera:camera-viewfinder、androidx.camera:camera-viewfinder-compose 或 androidx.camera:camera-viewfinder-core，就必須將依附元件轉換為以下項目：

  • androidx.camera:camera-viewfinder -> androidx.camera.viewfinder:viewfinder-view
  • androidx.camera:camera-viewfinder-compose -> androidx.camera.viewfinder:viewfinder-compose
  • androidx.camera:camera-viewfinder-core -> androidx.camera.viewfinder:viewfinder-core

您不需要變更程式碼即可進行這項轉換。舊版 Viewfinder Maven 座標將不再收到更新。

此外，如果您將 Compose 與 CameraX 搭配使用，現在 Alpha 版中提供新的 Compose 優先程式庫：androidx.camera:camera-compose。這會提供 CameraXViewfinder 可組合項，這是一種 Compose 慣用法的 Viewfinder，可將 CameraX 的 SurfaceRequest 調整為 Compose，類似於 PreviewView 如何為 View 運作。