---
title: 图像增强优化方案 - 图像清晰度增强优化
summary: 图像增强优化方案的 On-App AI 图像清晰度增强模块，支持网络/本地图片清晰度增强。依赖 chooseImage 和 downloadFile 接口，交互流程包括图片选择→远程图片下载→AI 清晰度增强→结果展示。
---

<h2 id="图像清晰度增强优化">图像清晰度增强优化 <span className="tag_h2">On-App AI</span></h2>

<div style="display: flex; align-items: center; justify-content: flex-start; margin-top: 20px;">
<img src="https://images.tuyacn.com/rms-static/4050cc20-8e20-11f0-9f57-5d628208d2a7-1757492961762.jpg?tyName=3273e8d7273d65d4c21446d742dc91cc.jpg" width="250" style="margin-right: 10px;">

<img src="https://images.tuyacn.com/rms-static/40502fe0-8e20-11f0-9f57-5d628208d2a7-1757492961758.jpg?tyName=241d6e5c0dd5ffbed17247176e183690.jpg" width="250" style="margin-right: 10px;">
</div>

### 功能介绍

对网络图像或本地相册图像做清晰增强优化。

依赖以下关键能力：

- **图像选择**：
    - [chooseImage](/cn/miniapp/develop/ray/api/media/image/chooseImage)：支持 C 端用户从本地相册选择图片或使用相机拍照。
- **下载文件**：
    - [downloadFile](/cn/miniapp/develop/ray/api/network/download/downloadFile)：下载文件资源到本地。

### 交互流程

```mermaid
sequenceDiagram
    participant 云端
    participant 用户
    participant 面板
    participant 系统相册
    participant 图像处理器

    rect rgb(15, 142, 167)
        Note over 面板: 图像选择
        用户 ->> 面板: 点击 “选择图片”
        面板 ->> 系统相册: chooseImage()
        系统相册 ->> 用户: 弹出相册界面
        用户 ->> 系统相册: 选择图像
        系统相册 -->> 面板: 返回原始图像 URI 列表
    end

    rect rgb(200, 34, 255)
        Note over 面板: 远程图像下载
        用户 ->> 面板: 点击 “优化”
        面板 ->> 云端: downloadFile()
        云端 ->> 面板:下载图像
        面板 -->> 面板: 返回图像本地地址
    end

    rect rgb(84, 163, 119)
        Note over 面板,图像处理器: 图像处理阶段
        面板 ->> 图像处理器: enhanceClarityForImage（原始 URI）
        图像处理器 ->> 图像处理器: AI 分析，并增强优化
        图像处理器 ->> 面板: 返回处理后临时 URI
    end

    rect rgb(255, 62, 130)
        Note over 面板,用户: 结果返回阶段
        面板 ->> 面板: 获取缓存地址
        面板 ->> 用户: 显示增强后的预览图
    end
```