1# 窗口子系统变更说明 2 3## cl.window.1 OH_NativeWindowManager_RegisterKeyEventFilter接口注册的回调事件中,回调函数参数Input_KeyEvent注入变更 4 5**访问级别** 6 7公开接口 8 9**变更原因** 10 11修复回调函数注入[Input_KeyEvent](../../../application-dev/reference/apis-input-kit/input.md)结构体的[Input_KeyEventAction](../../../application-dev/reference/apis-input-kit/input.md#input_keyeventaction)字段时,注入值无法匹配枚举的bug。变更前注入Input_KeyEventAction的值为1、2、3分别对应取消(KEY_ACTION_CANCEL)、按下(KEY_ACTION_DOWN)和抬起(KEY_ACTION_UP)三种行为,与枚举中定义的0(KEY_ACTION_CANCEL)、1(KEY_ACTION_DOWN)、2(KEY_ACTION_UP)不匹配。 12 13**变更影响** 14 15该变更为不兼容变更。<br/> 16变更前,注入Input_KeyEvent中的Input_KeyEventAction为1、2、3,无法匹配枚举。<br/> 17变更后,注入Input_KeyEvent中的Input_KeyEventAction为0、1、2,匹配枚举。<br/> 18 19**起始API Level** 20 21API 12 22 23**变更发生版本** 24 25从OpenHarmony 5.0.0.38 版本开始。 26 27**变更的接口/组件** 28 29OH_NativeWindowManager_RegisterKeyEventFilter接口中,回调函数OH_NativeWindowManager_KeyEventFilter的注入实现。 30 31**适配指导** 32 33注入行为bug修复,开发者之前用code作硬编码需要改为对应的Input_KeyEventAction枚举。 34 35## cl.window.2 startAbility/openLink锁屏时限制拉起行为 36 37**访问级别** 38 39公开接口 40 41**变更原因** 42 43锁屏时对任意拉起应用的行为增加限制。 44 45**变更影响** 46 47该变更为不兼容变更。 48变更前:锁屏时可调用startAbility/openLink接口正常拉起应用并正常保持应用窗口为前台状态。 49变更后:锁屏时调用startAbility/openLink接口拉起应用时,当应用窗口到前台状态时会被窗口管理阻止进而关闭窗口和应用。 50 51**起始API Level** 52 536 54 55**变更发生版本** 56 57从OpenHarmony SDK 5.0.0.71版本开始。 58 59**变更的接口/组件** 60 61startAbility/openLink 62 63涉及相关接口: 64UIAbilityContext: 65- startAbility(want: Want, options?: StartOptions) 66- startAbility(want: Want, callback: AsyncCallback<void>) 67- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 68- startAbilityByCall(want: Want) 69- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>) 70- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>) 71- startAbilityForResult(want: Want, options?: StartOptions) 72- startAbilityAsCaller(want: Want, options?: StartOptions) 73- startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>) 74- startAbilityForResultWithAccount(want: Want, accountId: number, options?: StartOptions) 75- startAbilityForResultWithAccount(want: Want, accountId: number, callback: AsyncCallback<AbilityResult>) 76- startAbilityForResultWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>) 77- startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions) 78- startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>) 79- startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>) 80- startRecentAbility(want: Want, options?: StartOptions) 81- startRecentAbility(want: Want, callback: AsyncCallback<void>) 82- startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 83- startAbilityByCallWithAccount(want: Want, accountId: number) 84- startAbilityAsCaller(want: Want, callback: AsyncCallback<void>) 85- openLink(link: string, options?: OpenLinkOptions, callback?: AsyncCallback<AbilityResult>) 86 87ServiceExtensionContext: 88- startAbility(want: Want, options?: StartOptions) 89- startAbility(want: Want, callback: AsyncCallback<void>) 90- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 91- startAbilityWithAccount(want: Want, accountId: number, options?: StartOptions) 92- startAbilityWithAccount(want: Want, accountId: number, callback: AsyncCallback<void>) 93- startAbilityWithAccount(want: Want, accountId: number, options: StartOptions, callback: AsyncCallback<void>) 94- startAbilityByCall(want: Want) 95- startAbilityAsCaller(want: Want, options?: StartOptions) 96- startAbilityAsCaller(want: Want, callback: AsyncCallback<void>) 97- startAbilityAsCaller(want: Want, options: StartOptions, callback: AsyncCallback<void>) 98- startRecentAbility(want: Want, options?: StartOptions) 99- startRecentAbility(want: Want, callback: AsyncCallback<void>) 100- startRecentAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 101- startAbilityByCallWithAccount(want: Want, accountId: number) 102- openLink(link:string, options?: OpenLinkOptions) 103 104UIExtensionContext: 105- startAbility(want: Want, options?: StartOptions) 106- startAbility(want: Want, callback: AsyncCallback<void>) 107- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 108- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>) 109- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>) 110- startAbilityForResult(want: Want, options?: StartOptions) 111- startAbilityForResultAsCaller(want: Want, options?: StartOptions) 112- openLink(link:string, options?: OpenLinkOptions, callback?: AsyncCallback<AbilityResult>) 113- openAtomicService(appId: string, options?: AtomicServiceOptions) 114 115AbilityDelegator: 116- startAbility(want: Want, callback: AsyncCallback<void>) 117 118InsightIntentContext: 119- startAbility(want: Want, callback: AsyncCallback<void>) 120 121FeatureAbility: 122- startAbility(parameter: StartAbilityParameter, callback: AsyncCallback<number>) 123- startAbilityForResult(parameter: StartAbilityParameter, callback: AsyncCallback<AbilityResult>) 124 125StaticSubscriberExtensionContext: 126- startAbility(want: Want, callback: AsyncCallback<void>) 127 128InputMethodExtensionContext: 129- startAbility(want: Want) 130 131AccessibilityExtensionContext: 132- startAbility(want: Want) 133 134FormExtensionContext: 135- startAbility(want: Want, callback: AsyncCallback<void>) 136 137WindowExtensionContext: 138- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>) 139 140**适配指导** 141 142锁屏时取消对相关接口的调用,否则会关闭被拉起的应用。 143