Live View Kit简介

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

场景介绍

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

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

通知中心	状态栏	锁屏

时段性

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

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

时效性

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

例：

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

权限调用、功能待机等系统状态，不属于实况窗。

变化性

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

产品优势

面向HarmonyOS 5.0及以上的全量手机、平板设备
实况窗特性与设备硬件完全解耦，开发者接入后，可以覆盖到所有HarmonyOS 5.0及以上的设备。

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

不打断现有的操作，用户可及时关注服务进展
状态栏的实况胶囊支持点击交互，用户可以在任何界面查看实况胶囊或者点击实况胶囊展开卡片，查看详细进展。

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

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

支持的范围与场景

说明

实况窗目前为Beta阶段，优先对受邀应用开放申请。
实况窗支持HarmonyOS 5.0及以上的操作系统版本。
实况窗当前仅支持手机和平板机型。

实况窗场景准入原则

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

实况窗支持对接的场景

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

受限说明

实况窗的推送受权益管控，应用接入时，需要根据文档的指导开通实况窗权益。
应用在推送实况窗通知时，本地实况窗创建依赖应用进程运行，创建后支持本地更新和通过Push Kit更新两种方式。
实况窗可以通过Push Kit进行更新，保证实况窗不依赖应用进程的存活。通过Push Kit的更新，实况窗完成在生命周期内正常的更新和结束。
单个实况窗的生命周期最长不超过8小时，超过8小时后，系统会认为实况窗结束。
通过Push Kit更新实况窗时，单个实况窗消息，出行打车与赛事比分场景每个设备每5分钟最多更新30次，每小时最多更新180次。其余场景每个设备每5分钟最多更新10次，每小时最多更新60次。超过频次部分将丢弃不下发。
为了确保用户看到内容的时效性，请您确保对实况窗内容进行及时更新。系统将在实况窗超过2小时未更新时，隐藏实况窗在状态栏胶囊和锁屏的展示，保留通知中心展示；超过4小时未更新，系统会认为实况窗结束，并从各个展示入口清除该实况窗。
用户可以在实况窗通知展示的任何时间点对某一实况窗通知进行删除，删除后，该实况窗通知的更新将不再展示。
通过Push Kit创建实况窗当前仅支持FLIGHT、TAXI、TRAIN场景。

使用入门

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

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

违规处罚

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

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

漫思