# photo

**Repository Path**: ObjectLeader/photo

## Basic Information

- **Project Name**: photo
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-30
- **Last Updated**: 2025-11-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 桌面图片轮播卡片应用

这是一个HarmonyOS应用，支持选择多张图片并将其添加到桌面作为轮播卡片。

## 功能特性

### 1. 多图片选择
- 使用 `PhotoViewPicker` API 实现多图片选择
- 支持一次选择最多30张图片
- 无需申请任何权限
- 实时预览选中的图片

### 2. 图片轮播预览
- 在应用内使用 Swiper 组件预览选中的图片
- 支持自动轮播
- 圆角阴影美化效果
- 自适应图片显示

### 3. 一键加桌
- 一键将选中的图片添加到桌面卡片
- 桌面卡片自动轮播显示图片
- 每3秒自动切换一张图片
- 支持2x2和2x4两种卡片尺寸

## 使用方法

### 步骤1：选择图片
1. 打开应用
2. 点击"选择图片"按钮
3. 在系统相册中选择1-30张图片
4. 确认选择

### 步骤2：预览图片
- 选择完成后，应用内会自动显示图片轮播预览
- 可以看到已选择的图片数量提示

### 步骤3：添加到桌面
1. 点击"一键加桌"按钮
2. 根据系统提示完成添加（部分设备需要手动长按桌面添加）
3. 在桌面上查看图片轮播卡片

### 手动添加卡片（备选方案）
如果一键加桌失败，可以手动添加：
1. 长按桌面空白处
2. 选择"服务卡片"或"小组件"
3. 找到本应用的卡片
4. 拖拽到桌面

## 技术实现

### 主要技术栈
- **ArkTS**: HarmonyOS原生开发语言
- **PhotoViewPicker**: 媒体库图片选择器API
- **FormExtensionAbility**: 卡片扩展能力
- **Swiper组件**: 图片轮播展示

### 核心代码文件
```
entry/src/main/ets/
├── pages/
│   └── Index.ets                    # 主页面：图片选择和预览
├── widget/
│   └── pages/
│       └── WidgetCard.ets          # 桌面卡片：图片轮播
└── entryformability/
    └── EntryFormAbility.ets        # 卡片生命周期管理
```

### 数据传递流程
1. 用户在主页面选择图片
2. 图片URI数组保存到 AppStorage
3. 点击加桌按钮触发卡片添加
4. FormAbility 从 AppStorage 读取图片数据
5. 通过 LocalStorage 传递给卡片页面
6. 卡片页面解析并展示图片轮播

## 注意事项

1. **图片权限**: 使用 PhotoViewPicker 无需申请权限，系统自动处理
2. **图片数量**: 建议选择3-10张图片以获得最佳轮播效果
3. **图片大小**: 选择的图片会被自动缩放适配卡片尺寸
4. **系统兼容**: 需要 HarmonyOS NEXT API 12 或更高版本
5. **卡片刷新**: 添加新卡片时会使用最新选择的图片

## 相关文档

- [PhotoViewPicker 开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/photoaccesshelper-photoviewpicker)
- [媒体资源使用指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/photoaccesshelper-resource-guidelines)
- [服务卡片开发指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/service-widget-overview)

## 开发环境

- DevEco Studio 5.0+
- HarmonyOS SDK API 12+
- Node.js 18+

## 许可证

MIT License