transferee.zip

# Transferee [](https://jitpack.io/#Hitomis/transferee) transferee 可以帮助你完成从缩略视图到原视图的无缝过渡转变, 优雅的浏览普通图片、长图、gif图、视频等不同格式的多媒体。 支持的功能: + 支持视频预览 + 支持 Gif 图预览 + 支持大长图预览 + 支持拖拽关闭 + 支持自定义页面索引指示器 + 支持自定义资源加载进度条 + 支持自定义图片加载器[目前已经有 UniversalImageLoader / GlideImageLoader / PicassoImageLoader] + 支持图片保存 + 支持预览图片缩放，拖动，旋转等手势操作 + 缩略图到大图或者大图到缩略图的无缝过渡动画，无缩略图信息时，自动改变动画的行为为平移过渡->加载大图->伸展图片动画 + 支持傻瓜式绑定 RecyclerView / ListView / GridView / ImageView + 支持不绑定任何 View, 即可启动 transferee 如有任何问题欢迎提 Issues # Preview <img src="preview/preview_1.gif" /><img src="preview/preview_2.gif" /><img src="preview/preview_3.gif" /> # Sample [demo.apk](https://github.com/Hitomis/transferee/tree/master/preview/app-release.apk) <img src="preview/memory.png" /> # Dependency step1. ``` allprojects { repositories { ... maven { url 'https://jitpack.io' } } } ``` step2. ``` // 添加所有 module [包括 Transferee、GlideImageLoader、PicassoImageLoader、UniversalImageLoader] implementation 'com.github.Hitomis:transferee:1.6.1' // 单独添加核心 module Transferee, 之后至少还需要添加以下三种图片加载器中的一种 implementation 'com.github.Hitomis.transferee:Transferee:1.6.1' // 添加 Glide 图片加载器 implementation 'com.github.Hitomis.transferee:GlideImageLoader:1.6.1' // 添加 Picasso 图片加载器 implementation 'com.github.Hitomis.transferee:PicassoImageLoader:1.6.1' // 添加 Universal 图片加载器 implementation 'com.github.Hitomis.transferee:UniversalImageLoader:1.6.1' ``` # Usage 如果针对单个 ImageView 使用，将非常简单： ``` Transferee transfer = Transferee.getDefault(context); transfer.apply(TransferConfig.build() .setImageLoader(UniversalImageLoader.with(getApplicationContext())) .setSourceUrlList(SourceConfig.getMixingSourceGroup()) .create() ).show()); // 离开页面不要忘记调用 transfer.destroy(); ``` 如果你需要更多的功能，下面是 transferee 完整的使用示例： step 1: 一个页面只创建一个 transferee 示例 (建议写在 onCreate 方法中) ``` transferee = Transferee.getDefault(context); ``` step 2: 为 transferee 创建参数配置器 ``` TransferConfig config = TransferConfig.build() .setSourceImageList(sourceUrlList) // 资源 url 集合, String 格式 .setSourceUriList(sourceUriList) // 资源 uri 集合， Uri 格式 .setMissPlaceHolder(R.mipmap.ic_empty_photo) // 资源加载前的占位图 .setErrorPlaceHolder(R.mipmap.ic_empty_photo) // 资源加载错误后的占位图 .setProgressIndicator(new ProgressPieIndicator()) // 资源加载进度指示器, 可以实现 IProgressIndicator 扩展 .setIndexIndicator(new NumberIndexIndicator()) // 资源数量索引指示器，可以实现 IIndexIndicator 扩展 .setImageLoader(GlideImageLoader.with(getApplicationContext())) // 图片加载器，可以实现 ImageLoader 扩展 .setBackgroundColor(Color.parseColor("#000000")) // 背景色 .setDuration(300) // 开启、关闭、手势拖拽关闭、显示、扩散消失等动画时长 .setOffscreenPageLimit(2) // 第一次初始化或者切换页面时预加载资源的数量，与 justLoadHitImage 属性冲突，默认为 1 .setCustomView(customView) // 自定义视图，将放在 transferee 的面板上 .setNowThumbnailIndex(index) // 缩略图在图组中的索引 .enableJustLoadHitPage(true) // 是否只加载当前显示在屏幕中的的资源，默认关闭 .enableDragClose(true) // 是否开启下拉手势关闭，默认开启 .enableDragHide(false) // 下拉拖拽关闭时，是否先隐藏页面上除主视图以外的其他视图，默认开启 .enableDragPause(false) // 下拉拖拽关闭时，如果当前是视频，是否暂停播放，默认关闭 .enableHideThumb(false) // 是否开启当 transferee 打开时，隐藏缩略图, 默认关闭 .enableScrollingWithPageChange(false) // 是否启动列表随着页面的切换而滚动你的列表，默认关闭 .setOnLongClickListener(new Transferee.OnTransfereeLongClickListener() { // 长按当前页面监听器 @Override public void onLongClick(ImageView imageView, String imageUri, int pos) { saveImageFile(imageUri); // 使用 transferee.getFile(imageUri) 获取缓存文件保存，视频不支持 } }) .bindImageView(imageView, source) // 绑定一个 ImageView, 所有绑定方法只能调用一个 .bindListView(listView, R.id.iv_thumb) // 绑定一个 ListView， 所有绑定方法只能调用一个 .bindRecyclerView(recyclerView, R.id.iv_thumb) // 绑定一个 RecyclerView， 所有绑定方法只能调用一个 ``` step 3: 显示 transferee ``` transferee.apply(config).show(); ``` step 4: 离开页面的时候需要销毁 transferee 中的资源，防止内存泄漏 (建议写在 onDestroy 方法中) ``` transferee.destroy() ``` # Config | 属性 | 说明 | | :--: | :--: | | sourceUrlList | 将要预览的资源 url 集合, String 格式 | | sourceUriList | 将要预览的资源 uri 集合， Uri 格式 | | nowThumbnailIndex | 缩略图在图组中的索引, 如果你绑定了 ListView 或者 RecyclerView，这个属性是必须的，否则可以忽略; 亦或可以作为打开 transferee 时指定初始化显示页面的 position | | offscreenPageLimit | 显示 transferee 时初始化加载的资源数量, 默认为1, 表示第一次加载3张(nowThumbnailIndex, nowThumbnailIndex + 1, nowThumbnailIndex - 1); 值为 2, 表示加载5张。依次类推 | | missPlaceHolder | 缺省的占位图，资源 id 格式。资源未加载完成时默认显示的图片 | | missDrawable | 缺省的占位图，Drawable 格式。资源未加载完成时默认显示的图片 | | errorPlaceHolder | 加载错误的占位图，资源 id 格式。原图加载错误时显示的图片 | | errorDrawable | 加载错误的占位图，Drawable 格式。原图加载错误时显示的图片 | | backgroundColor | transferee 显示时，transferee 背景色 | | duration | 开启、关闭、手势拖拽关闭、透明度动画显示、扩散消失等动画的时长 | | justLoadHitPage | 是否只加载当前页面中的资源。如果设置为 true，那么只有当 transferee 切换到当前页面时，才会触发当前页面的加载动作，否则按 offscreenPageLimit 所设置的数值去做预加载和当前页面的加载动作，默认关闭 | | enableDragClose | 是否支持向下拖拽关闭，默认开启 | | enableDragHide | 拖拽关闭时是否隐藏除主视图以外的其他 view， 默认开启 | | enableDragPause | 拖拽关闭时是否暂停当前页面视频播放， 默认关闭 | | enableHideThumb | 是否开启当 transferee 打开时，隐藏缩略图，默认开启 | | enableScrollingWithPageChange | 是否启动列表随着 page 的切换而滚动，仅仅针对绑定 RecyclerView/GridView/ListView 有效, 启动之后因为列表会实时滚动，缩略图 view 将不会出现为空的现象，从而保证关闭 transferee 时为过渡关闭动画， 默认关闭 | | progressIndicator | 资源加载进度指示器 (默认内置 ProgressPieIndicator 和 ProgressBarIndicator)。可实现 IProgressIndicator 接口定义自己的资源加载进度指示器 | | indexIndicator | 资源索引指示器 (默认内置 CircleIndexIndicator 和 NumberIndexIndicator)。可实现 IIndexIndicator