# LiveViewKit_Codelab_Clientdemo_ArkTS

**Repository Path**: harmonyos_codelabs/live-view-kit_-codelab_-clientdemo_-arkts

## Basic Information

- **Project Name**: LiveViewKit_Codelab_Clientdemo_ArkTS
- **Description**: 基于HarmonyOS实现即时配送场景下实况窗的创建、更新和结束功能。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-18
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Live View Kit-即时配送

## 简介
“Live View Kit-即时配送”基于HarmonyOS实现了即时配送场景下实况窗的创建、更新和结束功能。即时配送提供了待支付、待商家接单、待骑手接单、骑手已接单、骑手已到店、商品配送中、商品放入取餐柜和商品已送达，共8个状态。

## 相关概念
- 实况窗：实况窗是一种帮助用户聚焦正在进行的任务，方便快速查看和即时处理的通知形态。实况窗具有时效性、时段性、变化性的特点。
- 组件：Demo中主要使用了Text、Image等组件。
- liveViewManager：本模块提供Live View Kit的基础能力，包括创建、更新和停止实况窗、获取实况窗和检查实况窗开关的功能。

## 实际效果
| 即时配送主页                                            | 实况窗样例                                                     |
|---------------------------------------------------|-----------------------------------------------------------|
| ![](./entry/src/main/resources/rawfile/pages.png) | ![](./entry/src/main/resources/rawfile/notifications.png) |

## 工程目录

```
├─entry/src/main/ets       // 代码区  
│ ├─entryability                
│ │ └─EntryAbility.ets     // 程序入口类  
│ ├─pages                  // 存放页面文件目录                
│ │ ├─Index.ets            // 应用主页面，选择实况窗应用场景
│ │ └─InstantDelivery.ets  // 即时配送页面
│ ├─utils                  // 存放工具类文件目录
│ │ ├─ContextUtil.ets      // 上下文工具类
│ │ ├─LiveViewUtil.ets     // 实况窗工具类
│ │ └─LogUtil.ets          // 日志工具类
└─entry/src/main/resources // 资源文件目录
```

## 相关权限
不涉及

## 使用说明
1. 本Demo仅提供在本地创建、更新与结束实况窗的能力。
   - 若您需要使用本Demo，请替换AppScope/app.json5文件内的bundleName为您的包名。
     ![img.png](./entry/src/main/resources/rawfile/img.png)
   - 若您自己的包名未申请权益，请参考[指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-preparations)，先开通推送服务权益与实况窗权益。
2. 在“实况窗体验”页面，点击**即时配送**按钮，跳转到“即时配送”页面。
3. 在“即时配送”页面，点击**提交订单**按钮将创建一个待支付状态的实况窗。
4. 创建实况窗后，点击**更新进展**按钮可刷新实况窗状态。默认情况下，每隔15秒实况窗状态会自动更新一次。
5. 点击**结束订单**，将终止当前实况窗生命周期，15秒留存期后可点击**提交订单**再次创建实况窗。

## 约束与限制
1. HarmonyOS系统：HarmonyOS 5.0.0 Release及以上。
2. DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。
3. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。