imageviewer

Visualizador de imagens

Ele fornece um efeito visual de transição perfeita da visualização em miniatura para a visualização original e permite navegar com elegância por imagens comuns, longas e animadas.

Principais características

• Animação de transição: fornece animação de transição perfeita de miniatura para imagem grande ou de imagem grande para miniatura
• Gestos de navegação: ao navegar em imagens grandes, você pode usar gestos normais com as mãos, como aumentar e diminuir o zoom das imagens, etc.
• Carregamento de bloco de imagem de imagem supergrande (SubsamplingScaleImageView)
• Vídeo suporta carregamento de vídeo (ExoPlayer)
• Arraste para fechar e realizar operações para cima/para baixo na imagem grande para sair da navegação.
• Carregamento de dados em páginas: carregue dados de forma assíncrona enquanto navega em imagens grandes.
• Exclusão de dados
• Adição personalizada de UI personalizada de elementos de UI à página de visualização
• Adaptado para RTL

introduzir

 implementation 'com.github.iielse:imageviewer:x.y.z' 

O código de chamada mais simples

 fun show() { //
    val dataList： List<Photo> = // 将要展示的图片集合列表
    val clickedData: Photo = // 被点击的其中的那个图片元素信息
    val builder = ImageViewerBuilder(
        context = view.context,
        dataProvider = SimpleDataProvider(clickedData, dataList), // 一次性全量加载 // 实现DataProvider接口支持分页加载
        imageLoader = SimpleImageLoader(), // 可使用demo固定写法 // 实现对数据源的加载.支持自定义加载数据类型，加载方案
        transformer = SimpleTransformer(), // 可使用demo固定写法 // 以photoId为标示，设置过渡动画的'配对'.
    )
    builder.show()
}

 // 基本是固定写法. Glide 可以换成别的. demo代码中有video的写法.
class SimpleImageLoader : ImageLoader {
    /** 根据自身photo数据加载图片.可以使用其它图片加载框架. */
    override fun load(view: ImageView, data: Photo, viewHolder: RecyclerView.ViewHolder) {
        val it = (data as? MyData?)?.url ?: return
        Glide.with(view).load(it)
                .placeholder(view.drawable)
                .into(view)
    }

    /**
     * 根据自身photo数据加载超大图.subsamplingView数据源需要先将内容完整下载到本地.
     */
    override fun load(subsamplingView: SubsamplingScaleImageView, data: Photo, viewHolder: RecyclerView.ViewHolder) {
        val it = (data as? MyData?)?.url ?: return
        subsamplingDownloadRequest(it)
                .subscribeOn(Schedulers.io())
                .observeOn(AndroidSchedulers.mainThread())
                .doOnSubscribe { findLoadingView(viewHolder)?.visibility = View.VISIBLE }
                .doFinally { findLoadingView(viewHolder)?.visibility = View.GONE }
                .doOnNext { subsamplingView.setImage(ImageSource.uri(Uri.fromFile(it))) }
                .doOnError { toast(it.message) }
                .subscribe().bindLifecycle(subsamplingView)
    }

    private fun subsamplingDownloadRequest(url: String): Observable<File> {
        return Observable.create {
            try {
                it.onNext(Glide.with(appContext).downloadOnly().load(url).submit().get())
                it.onComplete()
            } catch (e: java.lang.Exception) {
                if (!it.isDisposed) it.onError(e)
            }
        }
    }

    private fun findLoadingView(viewHolder: RecyclerView.ViewHolder): View? {
        return viewHolder.itemView.findViewById<ProgressBar>(R.id.loadingView)
    }

    ......
}

 // 基本是可以作为固定写法.
class SimpleTransformer : Transformer {
    override fun getView(key: Long): ImageView? = provide(key)
    
    companion object {
        private val transition = HashMap<ImageView, Long>()
        fun put(photoId: Long, imageView: ImageView) {
            require(isMainThread())
            if (!imageView.isAttachedToWindow) return
            imageView.addOnAttachStateChangeListener(object : View.OnAttachStateChangeListener {
                override fun onViewAttachedToWindow(p0: View?) = Unit
                override fun onViewDetachedFromWindow(p0: View?) {
                    transition.remove(imageView)
                    imageView.removeOnAttachStateChangeListener(this)
                }
            })
            transition[imageView] = photoId
        }

        private fun provide(photoId: Long): ImageView? {
            transition.keys.forEach {
                if (transition[it] == photoId)
                    return it
            }
            return null
        }
    }
} 

Neste ponto a integração simples está completa.

Uso avançado.

(Implemente os três métodos a seguir. Exibições e funções personalizadas podem ser adicionadas)

• Personalize a IU em 'cada página'. Por exemplo, ela pode exibir mais informações sobre imagens. Fornece builder.setVHCustomizer(MyCustomViewHolderUI()) e compartilhamento e outras funções.
• Personalize a IU na 'camada de sobreposição (superior)'. Por exemplo, adicione indicadores, etc. builder.setOverlayCustomizer(MyCustomIndicatorUI())
• Monitore várias mudanças de estado do visualizador, incluindo troca builder.setViewerCallback(MyViewerStateChangedListener()) página (exibindo o status de execução da página atual da animação de transição);

 // 一般监听翻页onPageSelected可以控制 video播放的状态
// viewer 各状态监听回调
interface ViewerCallback : ImageViewerAdapterListener {
    // 当点击缩略图变化大图的瞬间
    override fun onInit(viewHolder: RecyclerView.ViewHolder) {}
    // 当图片被拖动时
    override fun onDrag(viewHolder: RecyclerView.ViewHolder, view: View, fraction: Float) {}
    // 当图片被拖动但不至于退出浏览
    override fun onRestore(viewHolder: RecyclerView.ViewHolder, view: View, fraction: Float) {}
    // 当图片被拖动执行退出浏览
    override fun onRelease(viewHolder: RecyclerView.ViewHolder, view: View) {}
    // 翻页中状态变化
    fun onPageScrollStateChanged(state: Int) {}
    // 翻页中
    fun onPageScrolled(position: Int, positionOffset: Float, positionOffsetPixels: Int) {}
    // 当某大图页面被选中
    fun onPageSelected(position: Int, viewHolder: RecyclerView.ViewHolder) {}
}

Configuração de parâmetros Geralmente não há necessidade de ajuste.

propriedade	Descrição da função
OFFSCREEN_PAGE_LIMIT	Número de itens pré-carregados pelo visualizador
VIEWER_ORIENTATION	direção de deslizamento do visualizador
VIEWER_BACKGROUND_COLOR	Cor de fundo ao visualizar imagens grandes (o padrão é preto puro)
DURATION_TRANSITION	Duração da animação de transição
DURATION_BG	Duração da mudança de fundo da animação de transição
SWIPE_DISMISS	Se deve ser compatível com o retorno de arrastar e soltar
SWIPE_TOUCH_SLOP	Arraste o limite de detecção de toque
DISMISS_FRACTION	Arraste para retornar ao limite
TRANSITION_OFFSET_Y	Corrigida a posição inicial da animação de transição na barra de status transparente

Definição de fonte de dados

 interface Photo {
    fun id(): Long // 每条图片数据的唯一标示. 主要用于分页数据加载. 定位过渡动画的对应关系
    fun itemType(): @ItemType.Type Int // 是否启用SubsamplingScaleImageView实现图片区块加载或ExoVideoView实现Video加载
}

Perguntas frequentes

• Como fechar e sair manualmente da página inteira?
• Como deletar um dado?

Obtenha a referência do objeto viewer por meio de ViewModelProvider(activity).get(ImageViewerActionViewModel::class.java) . Você pode então usar setCurrentItem(pos: Int) para mudar a posição da imagem grande para a posição especificada dismiss() para sair da navegação; a imagem grande; remove(item: List<Photo>) exclui elementos dentro dela;

• Como realizar a exibição do Vídeo? Você pode consultar a demonstração para implementar o local do código de demonstração SimpleViewerCustomizer
• Por que não há animação de transição? Transformer precisa ser configurado corretamente. É necessário garantir que o valor de retorno getView não seja nulo.
• Por que a execução da animação está muito desviada da imagem original? Observe o impacto da barra de status. Config.TRANSITION_OFFSET_Y

Outras notas importantes

demo pode ser executado. demo pode ser executado.

Todos vocês já viram isso, por que não clicam em Star [Wang Chai]

Obrigado

Se você acha que minha biblioteca de código aberto ajudou você a economizar muito tempo de desenvolvimento, você pode escanear o código QR abaixo para me recompensar. Seu incentivo é minha maior motivação para manter o projeto