文档开发者中心
我的
|

ArkUI (方舟UI框架)

UI

UX设计

Mate X7 模拟器已经进入悬停状态,系统折痕接口返回空数据

已解决

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

cke_221.png

点赞
收藏
3
回复
9
分享
举报
浏览85 发布于4天前山东
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

这就是模拟器的限制,不是你代码的问题。

模拟器切换折叠状态属于虚拟变化,没有物理铰链传感器,所以 display.getCurrentFoldCreaseRegion() 拿到的 creaseRects 是空数组。官方 FAQ 也确认过类似问题:云调试环境下 foldStatusChange 监听不到变化,原因一样——物理折叠状态变化是硬件事件,模拟器/云调试是软件模拟的状态切换,底层不会触发折痕区域数据上报。

模拟器与真机差异 屏幕属性 API - getCurrentFoldCreaseRegion

两个建议:

  1. 折痕避让功能验证用真机或云调试真机
  2. 开发阶段如果只想测布局,可以用 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() 会正常返回数据,降级逻辑不会触发。

展开全部
5楼回复于4天前 来自四川

先看应用读到的折叠状态。 蓝色折痕带是 DevEco 模拟器工具栏显示的提示。是否有折痕坐标,要看 display.getCurrentFoldCreaseRegion() 的返回值。官方文档没有列出额外开关,也未明确说明 Mate X7 模拟器镜像会返回空数组。模拟器工具栏 · 折痕接口

页面打开后重新切一次「展开 → 悬停」,确认 getFoldStatus() 返回 FOLD_STATUS_HALF_FOLDED、getFoldDisplayMode() 返回内屏模式 FOLD_DISPLAY_MODE_FULL,再读 creaseRects。如果状态正确、模拟器仍为空,而同一个包在真机上有值,就更可能是该模拟器镜像的限制或缺陷。 折叠状态与显示模式

6楼回复于4天前 来自广东

在模拟器悬停态下折痕接口返回空数据,通常与调用时机、接口选择或模拟器镜像版本有关。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%')
  }
}
展开全部
2楼编辑于4天前 来自北京

建议先确认你调用的是哪一个接口:实时折痕方法属于 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 接口。

9楼回复于4天前 来自四川

截图里的折痕示意区说明模拟器界面进入了相应形态,但不能单凭这张图判断某个折痕 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 接口。

8楼回复于4天前 来自四川

模拟器的折叠姿态是软件模拟,getFoldStatus 这类接口在上面经常返回 UNKNOWN 或者空值,真机才有真实折痕数据。布局别直接依赖返回值,先判断状态是否有效,无效就按最大屏宽走断点。要验折痕避让区,用 DevEco 的多设备预览加真机调试,模拟器只能看个大概。

7楼回复于4天前 来自天津

折痕接口在 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。实时折痕依赖真实铰链姿态数据,模拟器没有这个数据源,这部分属于模拟器当前的限制。需要说明:这是我的实测结论,官方文档没有明说模拟器上该接口为空,最终表现请以真机为准。

所以先对一下你调的是哪个接口:

  1. 如果调的是 getLiveCreaseRegion(),那模拟器上就是空,实时折痕相关逻辑只能上真机验证。
  2. 如果 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(屏幕属性),模拟器悬停态切换说明见使用工具栏。

展开全部
4楼回复于4天前 来自四川

先修正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/

以上未在你的镜像上运行,不承诺更换接口就一定返回非空。

3楼回复于4天前 来自湖北
学习
1楼回复于4天前 来自山东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。