LiveViewLockScreenExtensionAbility为锁屏沉浸实况窗可视化区的ExtensionAbility组件,继承自UIExtensionAbility,适用于需要在锁屏状态下展示丰富内容的实时活动场景。开发者通过继承该类并实现应用的扩展组件,可以在用户未解锁屏幕的情况下,在锁屏界面以可视化形式呈现更多的数据情况以及提供更多快速操作。
起始版本: 5.0.0(12)
LiveViewLockScreenExtensionAbility为独立子进程,不能跨进程拉起其他Ability。
为保障系统安全性和稳定性,防止LiveViewLockScreenExtensionAbility滥用系统资源,系统对其能力进行管控,不支持部分模块的引用,详情请参考附录。
import { LiveViewLockScreenExtensionAbility } from '@kit.LiveViewKit'; 设备行为差异: 该模块在Phone、Tablet中可正常调用,在其他设备类型中无效果。
锁屏沉浸实况窗扩展Ability,继承自UIExtensionAbility。
模型约束: 属性仅可在Stage模型下使用。
系统能力: SystemCapability.LiveView.LiveViewService
设备行为差异: 该接口在Phone、Tablet中可正常调用,在其他设备类型中无效果。
起始版本: 5.0.0(12)
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| context | LiveViewLockScreenExtensionContext | 否 | 否 | LiveViewLockScreenExtensionAbility的上下文环境,继承自ExtensionContext。 |
import { LiveViewLockScreenExtensionAbility } from '@kit.LiveViewKit';
import { UIExtensionContentSession, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
export default class LiveViewLockScreenExtAbility extends LiveViewLockScreenExtensionAbility {
onCreate(): void {
hilog.info(0x0000, 'LiveViewLockScreenTag', 'LiveViewLockScreenExtAbility onCreate begin.');
}
onSessionCreate(want: Want, session: UIExtensionContentSession): void {
hilog.info(0x0000, 'LiveViewLockScreenTag', 'LiveViewLockScreenExtAbility onSessionCreate begin.');
let param: Record<string, UIExtensionContentSession> = {
'session': session
};
let storage: LocalStorage = new LocalStorage(param);
// 解析从liveViewLocalScreenAbilityParameters中传入的参数
const parameters = want?.parameters;
let words: string = parameters?.['words'] ? parameters?.['words'] as string : 'Hello World!';
storage.setOrCreate('words', words);
// 加载锁屏沉浸实况窗页面
session.loadContent('pages/LiveViewLockScreenPage', storage);
}
} LiveViewLockScreenExtensionAbility不允许调用的API名单如下。