<h1 align="center">PhotoView</h1> 🌇 PhotoView 是一个 Android 的 ImageView 组件，通过多种触摸手势实现缩放功能。该项目是从 ChrisBanes 的 PhotoView 分支而来。

该库的目标是同步最新的 androidx 库，修复 bug，增强功能，并通过 Maven Central 而不是 Jitpack 分发软件包。

贡献 💙

PhotoView 由 Stream 维护。如果您对构建强大的实时视频/音频通话、音频室和直播感兴趣，请查看 Compose 版 Stream Video SDK！此外，任何人都可以按照我们的贡献指南来改进代码、文档或其他内容。

下载

Gradle

将以下依赖添加到您的模块的 build.gradle 文件中：

dependencies {
    implementation("io.getstream:photoview:1.0.2")
}

使用方法

PhotoView 可以像 ImageView 一样使用，如下例所示：

<io.getstream.photoview.PhotoView
    android:id="@+id/phptoView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:src="@drawable/wallpaper"/>

在使用第三方图片加载库如 Glide 或 Coil 时，可以按照以下示例加载图片。

Coil

val photoView = binding.photoView
photoView.load(IMAGE_URL) {
  crossfade(true)
}

Glide

val photoView = binding.photoView
Glide.with(this)
  .load(IMAGE_URL)
  .into(photoView)

查看 sample 目录可以找到多种实用示例，包括与 ViewPager 集成、使用共享过渡元素的 PhotoView、使用第三方图片库（如 Coil、Glide 和 Picasso）等。

PhotoView 对话框

您可以使用 photoview-dialog 包来实现显示 PhotoView 图片列表的对话框。首先，您可以简单地添加以下依赖：

dependencies {
    implementation("io.getstream:photoview-dialog:$version")
}

现在，您可以使用 PhotoViewDialog 组件来显示 PhotoView 图片对话框，如下所示：

val imageUrls = listOf(
  ..,
)

val button = binding.button
button.setOnClickListener {
  PhotoViewDialog.Builder(context = this, images = imageUrls) { imageView, url ->
    Glide.with(this)
      .load(url)
      .into(imageView)
  }.build().show()
}

然后，您将看到如下结果：

支持的功能

轻松缩放：通过多点触控手势和双击实现缩放功能。
顺畅滚动：提供流畅的滑动体验和惯性滚动效果。
兼容滚动父容器：与滚动容器（如 ViewPager）无缝集成，确保操作流畅。
矩阵变化通知：当显示的矩阵发生变化时通知应用程序，这对于根据当前缩放或滚动位置调整 UI 至关重要。
用户点击通知：当用户与照片交互时通知应用程序，便于响应式 UI 操作。

觉得这个仓库有用吗？:heart:

通过加入这个仓库的 stargazers 来支持它。:star: 另外，请在 GitHub 上 关注我，了解我的下一个创作！🤩

许可证

Copyright 2024 Stream.IO, Inc.
Copyright 2011, 2012 Chris Banes.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.