目录

Live View Kit简介

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

场景介绍

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

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

通知中心 状态栏 锁屏

[h2]时段性

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

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

[h2]时效性

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

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

[h2]变化性

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

产品优势

支持的范围与场景

[h2]实况窗场景准入原则

[h2]实况窗支持对接的场景

场景类型 EVENT取值 场景描述 场景范围
出行打车 TAXI 用户线上约车后，向用户展示司机接驾等待时间、行程中的剩余距离和时间等信息。

适用范围：

适用于网约车、出租车、拼车、顺风车等场景。
即时配送 DELIVERY 指配送员将餐品、商品送达到用户指定地点的业务场景，通常在较短时间内完成配送环节。

适用范围：

适用于外卖、生鲜配送、同城配送等场景。

不适用场景案例：

快递物流运输进度。
航班 FLIGHT 用户主动关注某个航班时，向用户展示航班的关键变动，如航班开始登机、航班起飞、航班延误、航班取消、航班到达等关键场景。

适用范围：

适用于用户通过航班出行或者主动关注某个航班进展的场景。

不适用场景案例：

模拟飞行、模拟航班等。
高铁/火车 TRAIN 用户通过高铁、火车出行，向用户展示检票口、座位号、车次信息及列车运行状态等信息。

适用范围：

适用于高铁出行、火车出行场景。
排队 QUEUE 需要通过排队叫号的方式，按顺序为用户提供服务的业务场景。

适用范围：

适用于办事大厅、医院、银行、餐饮等排队叫号能力场景。

不适用场景案例：

无进度排队、在线客服接入排队、文件下载排队等。
取餐 PICK_UP 指的是用户完成餐品/商品下单后，自行取餐或者取件的场景。

适用范围：

适用于餐饮线下取餐提醒，包括餐品排队情况、制作进度、取餐提醒等。

不适用场景案例：

模拟取餐、无进度取餐等。
赛事比分 SCORE 展示比赛双方成绩变化情况。

适用范围：

适用于游戏赛事、体育赛事等展示比分变化情况的场景。

不适用场景案例：

主播PK比分、象棋游戏等。
共享租赁 RENT 用户使用临时租赁服务时，向用户展示实时租赁时长和费用等租赁状态信息的场景。

适用范围：

适用于共享单车、共享充电宝、停车场临时停车、汽车快充充电场景。

不适用场景案例：

汽车慢充、家用智能家电设备状态、共享WIFI等。
计时 TIMER 用户主动设置并开启的倒计时场景。

适用范围：

适用于专注时刻、番茄时钟，仅限于工具类应用申请（计时场景仅支持通过端侧创建与更新）。

不适用场景案例：

取餐计时提醒、课程提醒、事项待办、会议日程提醒、录音、翻译计时、AI对话时长、待支付提醒、正计时等。
订阅计时 SUBSCRIBE_TIMER

● 用户主动手动订阅的演唱会售票、车票候补提醒，开售前向用户提醒开售倒计时抢购信息。

● 用户须在开播前主动手动订阅全球官方赛事后，才可向用户展示赛事开播实况窗，任何应用的赛事订阅开关不得默认选、自动订阅、批量弹窗。

适用范围：

适用于用户主动订阅的演唱会售票、车票候补提醒及全球官方赛事开播提醒场景。其中，演唱会售票须为正规渠道公开发售的场次，车票候补须为官方平台的有效候补订单；全球官方赛事须为全球性官方顶级赛事（如四年一届），且持有国内正规直播转播版权并具备全民级关注度，无版权赛事不开放实况窗开播订阅提醒。

不适用场景案例：

直播订阅（含电商直播、带货直播、娱乐秀场、日常自媒体）、体育联赛常规赛/分站赛、小众地区赛事或联赛，以及电商优惠抢购订阅、优惠券/红包/活动签到等场景，为用户主动订阅的单商品且单场次的开售倒计时抢购提醒服务。
运动锻炼 WORKOUT 运动过程中，向用户实时展示运动的时长和进度等信息。

适用范围：

适用于户外或室内的运动记录，如跑步、骑行。
导航 NAVIGATION 用户使用导航服务时，展示将要发生的路线变化。

适用范围：

适用于步行导航、骑行导航、车辆导航。

不适用场景案例：

虚拟导航、游戏导航等。
打卡 CHECK_IN 在上下班时间点，提醒用户打卡。

适用范围：

适用于上下班打卡场景。

不适用场景案例：

景区推荐/打卡、课程打卡、打卡挑战、直播打卡、居家办公打卡等。
快递 EXPRESS 用户存在待取件快递时，提醒用户取件。

适用范围：

适用于快递取件场景。

不适用场景案例：

未接入实况窗地理围栏的快递信息推送。
进度类型 PROGRESS 用户手动开启的上传/下载文件、音视频编辑导入/导出资源等场景下展示任务完成度。

适用范围：

适用于用户手动开启的上传/下载、资源导入/导出等场景下的任务进度提醒、AI任务，工具类应用。

不适用场景案例：

文件在后台自动上传/下载、资源在后台自动导入/导出、应用内资源下载等。
金融交易 TRADE 在用户证券交易进入买五至卖五核心交易区间通过实况窗展示交易变化如价格、挂单、成交等有效信息。

适用范围：

适用于股票、基金交易等场景下的成交进展提醒。

受限说明

[h2]通用约束限制

[h2]通过Push Kit创建和更新实况窗的约束限制

[h2]基于地理位置的实况窗提醒功能约束限制

模拟器支持情况

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

使用入门

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

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

违规处罚

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

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