# LiveViewKit_SampleCode_Clientdemo_ArkTS

**Repository Path**: GitIpman/live-view-kit_-sample-code_-clientdemo_-arkts

## Basic Information

- **Project Name**: LiveViewKit_SampleCode_Clientdemo_ArkTS
- **Description**: 基于HarmonyOS实现了即时配送场景下实况窗的创建、更新和结束功能。

- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 8
- **Created**: 2024-07-24
- **Last Updated**: 2024-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Live View Kit-即时配送

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

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

## 实际效果
| 即时配送主页 | 实况窗样例  |
| ------------ | ------------ |
| ![](./screenshots/pages.PNG)  | ![](./screenshots/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的包名，只需配置签名信息，即可使用本地构建实况窗的功能。推荐使用deveco的自动签名功能，选择 File->Project Stucture->Signing Configs，登录您的AGC账号后即可自动生成签名，如下图所示：
   ![](./screenshots/project_structure.PNG)
   - 若您要替换为您自己的包名，请参考[指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/liveview-preparations-V5)，先开通推送服务权益与实况窗权益。
2. 在“实况窗体验”页面，点击**即时配送**按钮，跳转到“即时配送”页面。
3. 在“即时配送”页面，点击**提交订单**按钮将创建一个待支付状态的实况窗。
4. 创建实况窗后，点击**更新进展**按钮可刷新实况窗状态。默认情况下，每隔15秒实况窗状态会自动更新一次。
5. 点击**结束订单**，将终止当前实况窗生命周期，15秒留存期后可点击**提交订单**再次创建实况窗。

## 约束与限制
1. HarmonyOS系统：HarmonyOS NEXT Developer Beta1及以上。
2. DevEco Studio版本：DevEco Studio NEXT Developer Beta1及以上。
3. HarmonyOS SDK版本：HarmonyOS NEXT Developer Beta1 SDK及以上。