Telephoto是开发者saket推出、基于Kotlin开发的Android Compose媒体交互开源组件库，适配各类Compose图像加载框架。原生解决Android应用大图浏览、手势缩放开发难题，提供成套可复用UI组件，核心包含可缩放图片、通用缩放修饰符、悬浮预览三大模块。内置大图自动子采样机制，规避内存溢出，支持平移缩放、嵌套滚动、屏幕旋转状态保存、键鼠快捷键等能力。项目持续迭代维护，完善测试用例覆盖多EXIF图片方向，配套完整文档与示例工程，大幅降低相册、看图、短视频类App媒体交互开发成本，是Compose生态轻量化优质图像解决方案。

Telephoto软件核心特色

开箱即用ZoomableImage组件

可直接替换原生Image组件，完整支持双指缩放、拖拽平移，自动对超大图片做子采样处理，杜绝大图加载OOM崩溃问题。

通用独立缩放Modifier修饰符

将缩放手势能力封装为独立Modifier，不局限图片，视频、自定义布局等任意Compose组件均可快速接入缩放交互。

仿Instagram悬浮预览Overlay

内置Zoomable Peek Overlay悬浮缩放效果，轻量弹窗预览大图，过渡动画流畅，快速实现社交类应用看图交互效果。

完善多场景兼容适配能力

支持HDR图像、嵌套滚动、屏幕旋转状态保存，兼容Coil、Glide主流图片加载框架，键鼠、键盘快捷键同步适配。

Telephoto软件怎么使用

1、打开Telephoto示例应用首页，页面以网格形式展示全部本地图片素材，点击任意一张图片进入全屏预览界面。

2、进入图片全屏浏览页，可双指缩放、拖动查看画面细节，右上角裁剪图标为图片编辑功能入口。

3、点击右上角裁剪按钮调出编辑框，拖动四角蓝色控制点调整画面范围，完成后选择保存或取消操作。

4、切换长图素材加载时，界面显示环形加载动画，库内置子采样机制流畅加载超高分辨率长幅图像。

5、打开竖向全景航拍大图，组件完整适配超长图片浏览，支持上下滑动、缩放，不会出现内存加载卡顿。

Telephoto库功能内容板块

ZoomableImage核心图像组件：

替代原生Image，集成手势、内存优化、点击监听、多缩放模式全套看图能力。

Modifier.zoomable通用缩放修饰器：

独立手势能力封装，复用至视频、画布、自定义视图等非图像控件。

Zoomable Peek Overlay悬浮预览模块：

临时弹窗式放大预览，带顺滑过渡动画，适配社交图片长按预览场景。

内存优化子采样引擎：

超大分辨率图片自动分块采样，缩放时保留细节，控制内存占用避免闪退。

多框架适配扩展包：

分别提供Coil、Glide专用依赖包，无缝对接主流Compose图片加载库。

示例Demo工程sample：

内置完整可运行代码案例，覆盖基础缩放、悬浮预览、键鼠交互等全部使用场景。

Telephoto软件怎么样，好用吗

接入成本极低，代码简洁易集成

组件可直接替换原生Image，仅需少量代码即可实现专业看图缩放，无需自研手势与内存处理逻辑。

内存管控优秀，适配高清大图场景

自动子采样技术解决原图加载内存溢出，相册、摄影、图纸类应用无需额外编写内存优化代码。

功能高度自定义，适配多样产品需求

缩放阻尼、回弹、最大最小缩放倍数、预览动画均可自定义，可贴合不同App视觉交互规范。

开源持续维护，生态完善稳定可靠

项目长期更新迭代，修复兼容性漏洞，配套完整文档、测试用例，商用无闭源授权风险。

综合测评

Telephoto是Compose生态里轻量化、高实用度的看图缩放开源库，核心优势是自动子采样完美解决大图内存问题，三大核心组件覆盖绝大多数媒体浏览需求。API设计简洁，兼容Coil、Glide，上手门槛低，自带示例工程便于快速调试。短板仅支持Android Compose，不适用于View体系项目，复杂多图层叠加场景自定义成本略高。整体非常适合相册、社交、文档看图类App开发，大幅缩减媒体交互开发周期，稳定无明显性能缺陷，值得Android Compose开发者引入使用。