Live View Kit（实况窗服务）支持应用将订单或者服务的实时状态信息变化在设备的关键界面展示，并对展示信息的生命周期、用户界面UI效果等进行管理。

## 场景介绍

实况窗是一种帮助用户聚焦正在进行的任务，方便快速查看和即时处理的通知形态，具有时段性、时效性、变化性的特点。

在展示形态上，实况窗支持在锁屏、通知中心、状态栏等位置展示，主要有两种展示形式：胶囊态和卡片态。

展开

| 通知中心 | 状态栏 | 锁屏 |
| --- | --- | --- |
|  |  |  |

### 时段性

该事件或服务需要持续一段时间，有明确的开始和结束，而非单点的提醒或信息。

例：打车、外卖等从事件开始到结束需要经历一段时间，属于实况窗；天气提示、电影票等单点提醒，则不属于实况窗。

### 时效性

内容为正在进行或即时发生的事件或服务的提醒，在特定时间段内，信息对用户有价值。

例：打车行程中、外卖配送中等正在进行的用户活动；2天后的机票，在刚买时不提醒，而在出发前提示，具体提醒时间根据业务实际情况确定，属于实况窗。权限调用、功能待机等系统状态，不属于实况窗。

### 变化性

实况窗所展示的内容需要动态更新，以确保用户看到最新的状态。

## 产品优势

* **面向HarmonyOS 5及以上的全量Phone、Tablet设备**

  实况窗特性与设备硬件完全解耦，开发者接入后，可以覆盖到所有HarmonyOS 5及以上的全量Phone、Tablet设备。

* **一步接入多触达点展示**

  开发者一次接入，可以实现包括锁屏、通知中心、状态栏在内多触达点展示实况窗。

* **不打断现有的操作，用户可及时关注服务进展**

  状态栏的实况胶囊支持点击交互，用户可以在任何界面查看实况胶囊或者点击实况胶囊展开卡片，查看详细进展。

  实况窗点击后也可直接进入落地页，方便用户快速进入应用查看。

* **服务全流程展示，提升业务履约效率**

  用户可以在多个触达点及时关注到服务的最新进展，帮助业务实现服务的快速、高效闭环，提升业务履约效率。

## 支持的范围与场景

说明

* 实况窗优先对满足场景准入原则和适用范围的应用开放申请。

* 实况窗支持**HarmonyOS 5及以上**的操作系统版本。
* 实况窗当前仅支持**Phone**和**Tablet**机型。
* 实况窗当前仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）。

### 实况窗场景准入原则

* 该活动场景是用户非常关注，且需要反复查看或快捷操作。
* 活动有开始和结束时间，且活动总时长较短，最长不得超过8小时。
* 用户对接收到该活动的实况窗通知有明确的预期，通常为用户主动行为触发实况窗通知。
* 需要确保展示内容对用户有足够的价值，且不可用于营销、广告场景。

### 实况窗支持对接的场景

展开

| **场景类型** | **EVENT取值** | **场景描述** | **适用范围** |
| --- | --- | --- | --- |
| 出行打车 | TAXI | 用户线上约车后，向用户展示司机接驾等待时间、行程中的剩余距离和时间等信息。 | 适用于网约车、出租车、拼车、顺风车等场景。 |
| 即时配送 | DELIVERY | 指配送员将餐品、商品送达到用户指定地点的业务场景，通常在较短时间内完成配送环节。 | 适用于外卖、生鲜配送、同城配送等场景。 |
| 航班 | FLIGHT | 用户主动关注某个航班时，向用户展示航班的关键变动，如航班开始登机、航班起飞、航班延误、航班取消、航班到达等关键场景。 | 适用于用户通过航班出行或者主动关注某个航班进展的场景。 |
| 高铁/火车 | TRAIN | 用户通过高铁、火车出行，向用户展示检票口、座位号、车次信息及列车运行状态等信息。 | 适用于高铁出行、火车出行的场景。 |
| 排队 | QUEUE | 需要通过排队叫号的方式，按顺序为用户提供服务的业务场景。 | 适用于办事大厅、医院、银行、餐饮等排队叫号能力场景。 |
| 取餐 | PICK\_UP | 指的是用户完成餐品/商品下单后，自行取餐或者取件的场景。 | 适用于餐饮线下取餐提醒，包括餐品排队情况、制作进度、取餐提醒等。 |
| 赛事比分 | SCORE | 展示比赛双方成绩变化情况。 | 适用于游戏赛事、体育赛事等展示比分变化情况的场景。 |
| 共享租赁 | RENT | 用户使用临时租赁服务时，向用户展示实时租赁时长和费用等租赁状态信息的场景。 | 适用于共享单车、共享充电宝、停车场临时停车、汽车快充充电场景。 |
| 计时 | TIMER | 用户在某个短时间段持续的正计时或任务前的倒计时场景。 | 适用于专注时刻、番茄时钟、抢票倒计时提醒场景，仅限于工具类应用申请（计时场景仅支持通过端侧创建与更新）。 |
| 订阅计时 | SUBSCRIBE\_TIMER | 用户主动订阅了某个商品的开售提醒后，开售前向用户提醒开售倒计时抢购信息。 | 适用于用户主动订阅的单商品且单场次的开售倒计时抢购提醒场景。 |
| 运动锻炼 | WORKOUT | 运动过程中，向用户实时展示运动的时长和进度等信息。 | 适用于户外或室内的运动记录，如跑步、骑行等。 |
| 导航 | NAVIGATION | 用户使用导航服务时，展示将要发生的路线变化。 | 适用于步行导航、骑行导航、车辆导航。 |

## 受限说明

* 实况窗的推送受权益管控，应用接入时，需要根据文档的指导[开通实况窗权益](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-preparations)。
* 应用在推送实况窗通知时，本地实况窗创建依赖应用进程运行，创建后支持本地更新和通过Push Kit更新两种方式。
* 实况窗可以通过Push Kit进行更新，保证实况窗不依赖应用进程的存活。利用Push Kit的推送服务，实况窗能够实现生命周期内的正常更新和结束。
* 单个实况窗的生命周期最长不超过8小时，超过8小时后，系统会认为实况窗结束。
* 通过Push Kit更新实况窗时，单个实况窗消息，出行打车与赛事比分场景每个设备每5分钟最多更新30次，每小时最多更新180次。其余场景每个设备每5分钟最多更新10次，每小时最多更新60次。超过频次部分将丢弃不下发。
* 为了确保用户看到内容的时效性，请开发者及时更新实况窗内容。系统会在以下情况自动调整实况窗的展示：
  + 超过2小时未更新：状态栏胶囊和锁屏胶囊将被隐藏，仅保留在通知中心展示；
  + 超过4小时未更新：系统将判定实况窗已结束，并从所有展示入口清除该实况窗。
* 用户可以在实况窗通知展示的任何时间点对某一实况窗通知进行删除，删除后，该实况窗通知的更新将不再展示。
* [通过Push Kit创建实况窗](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-update-liveview)当前仅支持FLIGHT、TAXI、TRAIN场景。
* 实况窗创建和更新有流控机制:
  + 系统级流控（针对所有应用），实况通知创建每秒最多15次，实况通知更新每秒最多30次，超过频次部分被丢弃不下发。
  + 应用级流控（针对单个应用），实况通知创建每秒最多10次，实况通知更新每秒最多20次，超过频次部分被丢弃不下发。

## 使用入门

开发者需要按照如下流程完成实况窗的开发工作。

展开

| 开发步骤 | 说明 |
| --- | --- |
| 依据[实况窗设计规范](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-design-formula)设计实况窗通知样式 | 依据样式模板设计开发者的实况窗通知范本。 |
| [开发准备](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-preparations) | 在[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)中申请实况窗权限。 |
| [构建本地实况窗](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-create-locally) | 根据[实况窗设计规范](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-design-formula)完成本地实况窗的开发。 |
| [通过Push Kit创建实况窗](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-update-liveview) | 通过Push Kit完成实况窗的创建。 |
| [通过Push Kit更新实况窗](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-update-by-push) | 通过Push Kit完成实况窗的更新。 |

## 违规处罚

应用发送的实况窗通知需同时遵守[实况窗设计规范](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/liveview-design-formula)和Push Kit的[通知内容原则](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-detail-rules)，如出现违反实况窗设计规范、通知内容原则等行为，将被视为违规。

违规行为及相应的处理措施请参见[违规分类、违规行为及违规处罚标准](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/push-punishment-standards#section1385731811412)。