# Live View Kit简介

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 | 用户使用导航服务时，展示将要发生的路线变化。 | 适用于步行导航、骑行导航、车辆导航。 |
| 打卡 | CHECK_IN | 在上下班时间点，提醒用户打卡。 | 适用于上下班打卡场景。 |
| 快递 | EXPRESS | 用户存在待取件快递时，提醒用户取件。 | 适用于快递取件场景。 |
| 进度类型 | PROGRESS | 在上传/下载文件、音视频编辑导入/导出资源等场景下展示任务完成度。 | 适用于文件上传/下载、资源导入/导出等场景下的任务进度提醒。 |

#### 受限说明

*   实况窗的推送受权益管控，应用接入时，需要根据文档的指导开通推送服务权益和开通实况窗服务权益。
    
*   应用在推送实况窗通知时，本地实况窗创建依赖应用进程运行，创建后支持本地更新和通过Push Kit更新两种方式。
    
*   实况窗可以通过Push Kit进行更新，保证实况窗不依赖应用进程的存活。利用Push Kit的推送服务，实况窗能够实现生命周期内的正常更新和结束。
    
*   单个实况窗的生命周期最长不超过8小时，超过8小时后，系统会认为实况窗结束。
    
*   通过Push Kit更新实况窗时，单个实况窗消息，出行打车与赛事比分场景每个设备每5分钟最多更新30次，每小时最多更新180次。其余场景每个设备每5分钟最多更新10次，每小时最多更新60次。超过频次部分将丢弃不下发。
    
*   为了确保用户看到内容的时效性，请开发者及时更新实况窗内容。系统会在以下情况自动调整实况窗的展示：
    
    *   超过2小时未更新：状态栏胶囊和锁屏胶囊将被隐藏，仅保留在通知中心展示；
    *   超过4小时未更新：系统将判定实况窗已结束，并从所有展示入口清除该实况窗。
*   用户可以在实况窗通知展示的任何时间点对某一实况窗通知进行删除，删除后，该实况窗通知的更新将不再展示。
    
*   通过Push Kit创建实况窗当前仅支持FLIGHT、TAXI、TRAIN场景。
    
*   实况窗创建和更新有流控机制：
    
    *   系统级流控（针对所有应用），实况通知创建每秒最多15次，实况通知更新每秒最多30次，超过频次部分被丢弃不下发。
    *   应用级流控（针对单个应用），实况通知创建每秒最多10次，实况通知更新每秒最多20次，超过频次部分被丢弃不下发。
*   从6.1.0(23)开始，支持基于地理位置的实况窗提醒功能，存在以下限制条件：
    
    *   基于地理位置的实况窗提醒次数限制：单设备单应用每日可最多注册5次。
    *   基于地理位置的实况窗提醒注册后，有效期为48小时，若超时未触发，系统将自动删除已过期的基于地理位置的实况窗提醒。
    *   当满足地理位置条件，触发创建或结束实况窗后，系统将自动删除该地理位置触发条件，不会再次触发创建或结束实况窗。
    *   运动锻炼（WORKOUT）和导航（NAVIGATION）场景不支持注册基于地理位置的实况窗提醒。
    *   基于地理位置的实况窗提醒依赖GNSS芯片的地理围栏功能，仅在室外开阔区域才能准确识别用户进出围栏事件并触发创建或结束实况窗。
    *   若“设置 > 通知和状态栏 > 实况窗”或“设置 > 应用和元服务”中的应用实况窗开关关闭，系统将自动删除该应用已注册但未触发的基于地理位置的实况窗提醒。
    *   若“设置 > 通知和状态栏 > 实况窗”，点击页面右上方4个点标记，点击“个性化提醒”，页面中“基于地理位置的实况窗提醒”开关关闭，系统将自动删除所有已注册但未触发的基于地理位置的实况窗提醒。
*   创建和更新本地实况窗场景，从26.0.0开始，传入图片PixelMap实例大小不大于192KB；对于26.0.0之前版本，传入图片PixelMap实例大小不大于30KB。
    
    *   为避免在26.0.0之前旧系统版本上实况窗无法显示PixelMap类型图片，要求在新旧系统版本上传入不同大小的图片PixelMap实例进行适配，请参考应用使用API如何在不同系统版本设备上做兼容性保护判断（ArkTS/C++）。

#### 模拟器支持情况

本Kit支持模拟器，但与真机存在部分能力差异，具体差异如下。

*   通用差异：请参见“模拟器与真机的差异”。
*   模拟器不支持基于地理位置的实况窗提醒、实况窗雨雪天气动效背景、实况窗连续服务按钮。

#### 使用入门

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

| 开发步骤 | 说明 |
| --- | --- |
| 依据实况窗设计规范设计实况窗通知样式 | 依据样式模板设计开发者的实况窗通知范本。 |
| 开发准备 | 在AppGallery Connect中申请实况窗权限。 |
| 构建本地实况窗 | 根据实况窗设计规范完成本地实况窗的开发。 |
| 通过Push Kit创建实况窗 | 通过Push Kit完成实况窗的创建。 |
| 通过Push Kit更新实况窗 | 通过Push Kit完成实况窗的更新。 |

#### 违规处罚

应用发送的实况窗通知需同时遵守实况窗设计规范和Push Kit的通知内容原则，如出现违反实况窗设计规范、通知内容原则等行为，将被视为违规。

违规行为及相应的处理措施请参见违规分类、违规行为及违规处罚标准。