# Hdemo

**Repository Path**: HeDongbo/hdemo

## Basic Information

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

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-21
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 鸿蒙案例

## README

## ✨ 核心功能

### 1. 🏷️ @人功能（AI Text Editor）

实现类似社交平台的@人功能，支持在富文本编辑器中提及用户。

**特性：**

- ✅ 在输入框中输入 `@` 触发用户选择
- ✅ 支持@多个用户，每个用户标记唯一
- ✅ 支持编辑、删除已@的用户
- ✅ 双击删除保护，避免误操作
- ✅ 位置信息自动同步和更新
- ✅ 支持内容持久化和恢复
- ✅ 实时获取编辑器内容和@人信息

**核心文件：**

- `pages/AiTePage.ets` - @人功能页面
- `components/AiTeEditor.ets` - 自定义富文本编辑器组件

### 2. 🎬 视频播放器

功能完善的视频播放器，支持横竖屏切换、倍速播放等。

**特性：**

- ✅ 支持横竖屏自动适配和手动切换
- ✅ 全屏沉浸式播放体验
- ✅ 多倍速播放（0.75x、1.0x、1.25x、1.75x、2.0x）
- ✅ 播放进度拖拽和手势控制
- ✅ 播放/暂停控制
- ✅ 时间显示和进度条
- ✅ 双击播放/暂停，单击显隐控制条
- ✅ 自适应视频宽高比

**核心文件：**

- `pages/VideoPage.ets` - 视频播放器页面
- `utils/TimeTools.ts` - 时间格式化工具

### 3. ✂️ 图片裁剪

强大的图片裁剪功能，支持多种裁剪比例和自由裁剪。

**特性：**

- ✅ 多种预设裁剪比例（1:1、4:3、16:9、3:4、9:16）
- ✅ 自由裁剪模式
- ✅ 裁剪框大小锁定功能
- ✅ 九宫格辅助线
- ✅ 裁剪框拖拽和缩放
- ✅ 八方向控制点（四角 + 四边中点）
- ✅ 图片选择（从相册）
- ✅ 裁剪结果保存到相册
- ✅ 遮罩层效果
- ✅ 自动居中和边界限制
- ✅ 高度可配置（样式、行为、UI）

**核心文件：**

- `pages/CropPage.ets` - 图片裁剪页面

### 4. 📥 下载管理

完整的文件下载管理系统，支持多任务、暂停继续、持久化等。

**特性：**

- ✅ 多文件并发下载
- ✅ 下载进度实时显示
- ✅ 暂停/继续下载
- ✅ 下载任务持久化（应用退出后可恢复）
- ✅ 下载状态管理（等待、下载中、已完成、失败、已暂停）
- ✅ 文件大小格式化显示
- ✅ 下载任务列表管理
- ✅ 滑动删除任务
- ✅ 下载完成通知
- ✅ 支持应用重启后恢复下载（基于系统任务查询）

**核心文件：**

- `pages/DownloadListPage.ets` - 下载列表管理页面
- `pages/DownLoadTestPage.ets` - 下载测试页面
- `utils/DownloadManager.ets` - 下载管理器
- `utils/PreferenceUtil.ets` - 数据持久化工具

**技术亮点：**

- 使用 `request.agent` API 实现后台下载
- 通过 `tid` 实现任务持久化和恢复
- 事件监听器自动注册和管理
- 下载状态和进度实时同步

```

## 🛠️ 技术栈

- **开发语言**：ArkTS (TypeScript 扩展)
- **UI 框架**：ArkUI (声明式 UI)
- **构建工具**：hvigor
- **最低 API 版本**：API 9+
- **推荐开发工具**：DevEco Studio

## 📦 核心依赖

- `@kit.ArkUI` - UI 框架和路由
- `@kit.BasicServicesKit` - 基础服务（下载等）
- `@kit.ImageKit` - 图片处理
- `@kit.MediaLibraryKit` - 媒体库访问
- `@kit.CoreFileKit` - 文件操作
- `@ohos.multimedia.media` - 多媒体播放

## 🚀 快速开始

### 环境准备

1. 安装 [DevEco Studio](https://developer.harmonyos.com/cn/develop/deveco-studio/)
2. 配置 HarmonyOS SDK
3. 准备 HarmonyOS 设备或模拟器

### 安装依赖

```bash
# 使用 ohpm 安装依赖
ohpm install
```

### 构建项目

```bash
# 使用 hvigor 构建
hvigor build
```

### 运行项目

1. 连接 HarmonyOS 设备或启动模拟器
2. 在 DevEco Studio 中点击运行按钮
3. 或使用命令行：

```bash
hvigor run
```