幽蓝ArkUI (方舟UI框架)
UI
UX设计
Mate X7 模拟器已经进入悬停状态,系统折痕接口返回空数据
Mate X7 模拟器已经进入悬停状态,界面也显示了折痕避让区,但系统折痕接口返回空数据,这是模拟器当前的限制,还是需要其他设置?

仙银
这就是模拟器的限制,不是你代码的问题。
模拟器切换折叠状态属于虚拟变化,没有物理铰链传感器,所以 display.getCurrentFoldCreaseRegion() 拿到的 creaseRects 是空数组。官方 FAQ 也确认过类似问题:云调试环境下 foldStatusChange 监听不到变化,原因一样——物理折叠状态变化是硬件事件,模拟器/云调试是软件模拟的状态切换,底层不会触发折痕区域数据上报。
模拟器与真机差异 屏幕属性 API - getCurrentFoldCreaseRegion
两个建议:
- 折痕避让功能验证用真机或云调试真机
- 开发阶段如果只想测布局,可以用
FolderStack或FoldSplitContainer组件,它们在模拟器悬停态下会自动处理避让布局,不需要你手动读折痕区域数据。如果你是自定义实现悬停态,可以在模拟器环境做降级:检测到creaseRects为空时,按悬停态的典型折痕位置硬编码一个占位区域来调试布局
import { display } from '@kit.ArkUI';
@Entry
@ComponentV2
struct FoldCreasePage {
@Local creaseRects: Array<display.Rect> = []
@Local foldStatus: display.FoldStatus = display.FoldStatus.FOLD_STATUS_UNKNOWN
aboutToAppear(): void {
this.foldStatus = display.getFoldStatus()
this.updateCreaseRegion()
display.on('foldStatusChange', (status: display.FoldStatus) => {
this.foldStatus = status
this.updateCreaseRegion()
})
}
private updateCreaseRegion(): void {
try {
const region: display.FoldCreaseRegion = display.getCurrentFoldCreaseRegion()
this.creaseRects = region.creaseRects
if (this.creaseRects.length === 0 && this.foldStatus === display.FoldStatus.FOLD_STATUS_HALF_FOLDED) {
const defaultDisplay: display.Display = display.getDefaultDisplaySync()
const creaseHeight: number = 84
this.creaseRects = [{
left: 0,
top: Math.floor(defaultDisplay.height / 2 - creaseHeight / 2),
width: defaultDisplay.width,
height: creaseHeight
}]
}
} catch (error) {
console.error(`Failed to get crease region. Code: ${(error as BusinessError).code}`)
}
}
aboutToDisappear(): void {
display.off('foldStatusChange')
}
build(): void {
Column() {
Text(`FoldStatus: ${this.foldStatus}`)
.fontSize(16)
Text(`CreaseRects count: ${this.creaseRects.length}`)
.fontSize(16)
ForEach(this.creaseRects, (rect: display.Rect, index: number) => {
Text(`Rect[${index}]: left=${rect.left} top=${rect.top} w=${rect.width} h=${rect.height}`)
.fontSize(14)
}, (_: display.Rect, index: number) => `${index}`)
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
}
}
代码里 updateCreaseRegion 做了降级:当悬停态下 creaseRects 为空时,按屏幕中间位置模拟一个折痕区域,这样模拟器上也能调试避让布局。真机上 getCurrentFoldCreaseRegion() 会正常返回数据,降级逻辑不会触发。
蓝瘦的蜕变
先看应用读到的折叠状态。 蓝色折痕带是 DevEco 模拟器工具栏显示的提示。是否有折痕坐标,要看 display.getCurrentFoldCreaseRegion() 的返回值。官方文档没有列出额外开关,也未明确说明 Mate X7 模拟器镜像会返回空数组。模拟器工具栏 · 折痕接口
页面打开后重新切一次「展开 → 悬停」,确认 getFoldStatus() 返回 FOLD_STATUS_HALF_FOLDED、getFoldDisplayMode() 返回内屏模式 FOLD_DISPLAY_MODE_FULL,再读 creaseRects。如果状态正确、模拟器仍为空,而同一个包在真机上有值,就更可能是该模拟器镜像的限制或缺陷。 折叠状态与显示模式
华夏
在模拟器悬停态下折痕接口返回空数据,通常与调用时机、接口选择或模拟器镜像版本有关。display.getCurrentFoldCreaseRegion() 返回的 FoldCreaseRegion 对象包含 displayId 和 creaseRects 数组,每个 creaseRect 是一个 Rect(left、top、width、height,单位为物理像素 px)。如果 creaseRects 为空数组或对象为 undefined,可按以下思路逐一排查。
排查步骤:
1. 调用时机问题
折痕区域数据在折叠状态切换后才会更新。如果在应用启动时(aboutToAppear 阶段)直接调用,可能尚未拿到有效数据。正确做法是在 display.on('foldStatusChange') 回调中,确认状态变为半折叠(FOLD_STATUS_HALF_FOLDED,值为 3)后再获取折痕区域。
2. 悬停态应使用实时折痕接口
API 20 新增了 display.getLiveCreaseRegion(),用于获取实时折痕区域,比 getCurrentFoldCreaseRegion() 更适合动态折叠角度场景(如悬停态)。如果您的模拟器镜像支持 API 20 及以上,建议优先使用该接口。
3. 模拟器镜像版本限制
模拟器对折痕区域接口的支持与镜像版本相关。如果镜像版本较低,getLiveCreaseRegion(API 20+)可能不可用,或折痕数据模拟不完整。建议确认模拟器镜像对应的 API 版本,并升级到最新镜像。
4. 坐标与单位注意
即使拿到数据,getCurrentFoldCreaseRegion() 返回的是全局坐标和物理像素,直接将 rect.top 当 vp 使用会导致避让区域在不同密度或窗口模式下偏移,需要做 px→vp 转换。
参考代码:
import { display } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
@Entry
@Component
struct HoverCreasePage {
// 是否处于悬停态
@State isHover: boolean = false;
// 折痕区域(px)
@State creaseRects: Array<display.Rect> = [];
aboutToAppear(): void {
try {
// 监听折叠状态变化,在回调中获取折痕区域
display.on('foldStatusChange', (foldStatus: display.FoldStatus) => {
if (foldStatus === display.FoldStatus.FOLD_STATUS_HALF_FOLDED) {
this.isHover = true;
this.queryCreaseRegion();
} else {
this.isHover = false;
this.creaseRects = [];
}
});
} catch (err) {
let e: BusinessError = err as BusinessError;
console.error(`监听折叠状态失败, code: ${e.code}, message: ${e.message}`);
}
}
aboutToDisappear(): void {
// 页面退出时取消监听
try {
display.off('foldStatusChange');
} catch (err) {
let e: BusinessError = err as BusinessError;
console.error(`取消监听失败, code: ${e.code}, message: ${e.message}`);
}
}
private queryCreaseRegion(): void {
try {
// 方式一:API 20+ 使用实时折痕接口,适合悬停态
let region: display.FoldCreaseRegion = display.getLiveCreaseRegion();
if (region.creaseRects !== undefined && region.creaseRects.length > 0) {
this.creaseRects = region.creaseRects;
} else {
// 方式二:降级使用当前显示模式折痕接口
let currentRegion: display.FoldCreaseRegion = display.getCurrentFoldCreaseRegion();
if (currentRegion.creaseRects !== undefined) {
this.creaseRects = currentRegion.creaseRects;
} else {
console.warn('折痕区域为空,请检查模拟器镜像版本是否支持折痕模拟');
}
}
} catch (err) {
let e: BusinessError = err as BusinessError;
console.error(`获取折痕区域失败, code: ${e.code}, message: ${e.message}`);
}
}
build() {
Column() {
Text(`悬停态: ${this.isHover ? '是' : '否'}`)
.fontSize(20)
.margin(20)
ForEach(this.creaseRects, (rect: display.Rect) => {
Text(`折痕区域: left=${rect.left}, top=${rect.top}, width=${rect.width}, height=${rect.height}`)
.fontSize(14)
.margin(10)
}, (rect: display.Rect, index: number) => index.toString())
}
.width('100%')
.height('100%')
}
}
橙动创意建议先确认你调用的是哪一个接口:实时折痕方法属于 Display 实例,不能直接写成 display.getLiveCreaseRegion()。
import { display } from '@kit.ArkUI';
const screen = display.getDefaultDisplaySync();
console.info(`displayId=${screen.id}`);
// 模块接口:
console.info(JSON.stringify(display.getCurrentFoldCreaseRegion()));
// API 20+ 的 Display 实例接口:
console.info(JSON.stringify(screen.getLiveCreaseRegion()));
实际定位时把每个调用分别包在 try/catch 中,记录错误码,并区分“抛错、undefined、rects 空数组”。在折叠状态/显示模式改变后重新查询,再用同一段代码对照真机。
模拟器显示的蓝色避让示意区域,不足以证明对应镜像一定向每个折痕 API 提供数据。若仍为空,附上 DevEco、镜像/API 完整版本、displayId 和这组结果反馈,才能判断是接口使用问题还是该镜像能力限制;页面兜底不要硬编码截图里的折痕尺寸。
参考:Display 接口。
训犬者截图里的折痕示意区说明模拟器界面进入了相应形态,但不能单凭这张图判断某个折痕 API 必然返回有效区域。先把调用接口和“空”的具体含义分开记录。
import { display } from '@kit.ArkUI';
console.info(`fold=${display.getFoldStatus()}`);
console.info(`mode=${display.getFoldDisplayMode()}`);
console.info(JSON.stringify(display.getCurrentFoldCreaseRegion()));
// API 20+,这是 Display 实例的方法:
console.info(JSON.stringify(
display.getDefaultDisplaySync().getLiveCreaseRegion()));
实际排查时每个调用分别 try/catch,记录错误码,区分 undefined、rects 为空和抛错。折叠状态与显示模式变化后重新查询,并记录镜像版本、API 和 displayId,再用相同代码对照真机。
getCurrentFoldCreaseRegion 是模块方法,getLiveCreaseRegion 是 Display 实例方法,二者不能混写成同一个调用。未核对镜像与接口前,不宜把结论扩大为“所有模拟器都不支持”;生产布局也不要硬编码截图中的蓝色区域尺寸。
参考:Display 接口。
匿名用户模拟器的折叠姿态是软件模拟,getFoldStatus 这类接口在上面经常返回 UNKNOWN 或者空值,真机才有真实折痕数据。布局别直接依赖返回值,先判断状态是否有效,无效就按最大屏宽走断点。要验折痕避让区,用 DevEco 的多设备预览加真机调试,模拟器只能看个大概。
Z折痕接口在 Mate X7 模拟器上不是整体不可用。我在折叠屏模拟器上实测(DevEco Studio 26.0.0.821,HarmonyOS 6.1.0(23) 镜像,工具栏切到悬停态,FoldStatus=3),悬停态下 getCurrentFoldCreaseRegion()(API 10+)能正常返回折痕区域:
getCurrentFoldCreaseRegion: displayId=0, creaseRects.length=1,
rects=[{left:0, top:1064, width:2496, height:171}]
真正返回空的是 getLiveCreaseRegion()(API 20+,实时折痕区域),底层日志报 single_display_fold_policy.cpp GetFoldCreaseRegion: foldRect is invalid。实时折痕依赖真实铰链姿态数据,模拟器没有这个数据源,这部分属于模拟器当前的限制。需要说明:这是我的实测结论,官方文档没有明说模拟器上该接口为空,最终表现请以真机为准。
所以先对一下你调的是哪个接口:
- 如果调的是
getLiveCreaseRegion(),那模拟器上就是空,实时折痕相关逻辑只能上真机验证。 - 如果
getCurrentFoldCreaseRegion()也返回空,一般是调用姿势问题:一是要在display.on('foldStatusChange')回调里重新查询,不要只在页面初次加载时查一次;二是折叠态外屏显示(FOLD_DISPLAY_MODE_MAIN / SUB)下本来就没有折痕,返回空是正常的。
悬停态判定不需要依赖折痕接口,foldStatusChange 回调返回 FOLD_STATUS_HALF_FOLDED(值 3)就是悬停态,模拟器上这个事件正常下发。
另外,如果目的只是悬停态布局避让,可以完全不碰折痕接口,直接用 FolderStack 或 FoldSplitContainer,系统组件会自动避让折痕区。
最小验证 demo(模拟器、真机通用):
import { display } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
const TAG: string = 'FoldCreaseDemo';
@Entry
@Component
struct Index {
@State result: string = 'not queried';
private query(): void {
try {
const region: display.FoldCreaseRegion = display.getCurrentFoldCreaseRegion();
let rects: string[] = [];
for (let i = 0; i < region.creaseRects.length; i++) {
const r = region.creaseRects[i];
rects.push(`{left:${r.left}, top:${r.top}, width:${r.width}, height:${r.height}}`);
}
this.result = `creaseRects.length=${region.creaseRects.length}`;
hilog.info(0, TAG, `getCurrentFoldCreaseRegion: displayId=${region.displayId}, rects=[${rects.join('; ')}]`);
} catch (e) {
const err = e as BusinessError;
hilog.error(0, TAG, `getCurrentFoldCreaseRegion failed: ${err.code} ${err.message}`);
}
}
aboutToAppear(): void {
display.on('foldStatusChange', (status: display.FoldStatus) => {
// 3 = FOLD_STATUS_HALF_FOLDED,即悬停态
hilog.info(0, TAG, `foldStatusChange: ${status}`);
this.query();
});
this.query();
}
build() {
Column({ space: 12 }) {
Text(this.result).fontSize(20)
Button('refresh').onClick(() => this.query())
}
.width('100%')
.height('100%')
.padding(16)
}
}
跑起来后在模拟器工具栏点悬停按钮,看 hilog 输出即可。
接口定义见 @ohos.display(屏幕属性),模拟器悬停态切换说明见使用工具栏。
大雷神先修正2楼示例的调用位置:API 20起的 getLiveCreaseRegion() 是 display.Display 实例方法,官方写法是先获取 display.getDefaultDisplaySync(),再在返回的 Display 对象上调用 getLiveCreaseRegion(),不是直接调用 display.getLiveCreaseRegion()。升级镜像并不能修复这个调用层级问题。
另外,foldStatusChange 与 foldDisplayModeChange 不是同一个事件。官方说明前者是物理折叠状态变化,物理状态变化在前,底层随后匹配显示模式;getCurrentFoldCreaseRegion 返回的又是“当前显示模式下”的折痕区域。因此不能把“已收到半折叠状态”直接等同于“显示模式及折痕信息已全部更新”。
建议先做最小探针,分别在应用进入后、物理状态变化时、显示模式变化时记录时间和结果:
- 实际使用的接口名称、当前系统/API及模拟器镜像版本;
- 完整返回对象,明确区分 undefined、对象存在但 creaseRects 为空、以及抛异常;
- 若走 Display 实例接口,记录所取 Display 的id和返回区域的displayId,确认不是取到了另一块屏幕。
这三类结果应分开处理。官方对 getCurrentFoldCreaseRegion 说明:非折叠设备返回 undefined;对 Display.getLiveCreaseRegion 列出801能力不支持、1400003显示管理服务异常。不要把这些错误统一捕获后转成空数组,否则很难判断是能力、屏幕选择还是数据尚未更新。若界面已经处于悬停态,再让开发者主动点一次“读取”按钮,也能帮助排除仅在启动时查询或漏掉事件的影响。
目前仅凭“模拟器显示了避让区”还不能确定应用侧接口必定提供相同数据,也没有核实到你所用镜像存在统一的折痕接口限制。先修正实例方法调用、保留原始结果,再用同一最小探针对照真机;若仅特定镜像异常,带镜像版本和上述时序结果反馈,会比直接写死避让高度更有依据。
官方依据:display API中的 Display.getLiveCreaseRegion、display.getCurrentFoldCreaseRegion、foldStatusChange说明与示例:
https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-display/
以上未在你的镜像上运行,不承诺更换接口就一定返回非空。
二元文化- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS 开通地图服务,模拟器地图不显示 (API12+)
HarmonyOS 设备管理器中模拟器已开启,但没有显示模拟器(API12+)
HarmonyOS 在WIN系统下使用模拟器调试崩溃,模拟器内存占用太高 (API12+)
HarmonyOS 模拟器怎么安装其它应用 (API12+)
HarmonyOS FolderStack组件实现的悬停,在双折叠手机上,避让区被填充了 (API12+)
HarmonyOS 折叠屏远程真机屏幕状态判断(API12+)
拒绝拉伸与留白:Pura X Max 鸿蒙应用适配 Top4 体验优化场景升级指引
退出应用后重新进入页面会在上个页面多停留1-2秒




































苏公安网备 32011402010933号