Qt 鸿蒙平板适配实战:一份源码,两条构建链,一个布局契约

Qt for OpenHarmony 能用的预编译 SDK 是 5.12.12,桌面这边是 Qt 6.11 加 CMake。两边跑同一份 src/ 和同一份 QML,差别全在包装层:一边靠 qt_add_qml_module() 自动注册类型,另一边靠 qmlRegisterType() 手写。旋转窗口最后被做成 static 纯函数,两边各自只负责把类型注册回去。

仓库地址:https://atomgit.com/lqjmac/tablet-adaptive-qt
三方框架版本:https://wiki.qt.io/Qt_for_HarmonyOS
组织仓库链接:https://atomgit.com/ohos-qt

0. 环境与实测设备

三方库适配信息:

三方库版本形态仓库地址
tablet-adaptive-qt1.0.0Qt Quick / QML 库(桌面 Qt 6.5+ CMake;Qt for OpenHarmony 5.12.12 + qmake 交叉编译,同一份源码)https://atomgit.com/lqjmac/tablet-adaptive-qt

实测环境:

项版本/型号
桌面构建链Qt 6.11.0、CMake 4.3.2(要求 Qt 6.5+ / CMake 3.21+ / C++17)
OHOS 构建链Qt for OpenHarmony 5.12.12 预编译 SDK(qmake,arm64-v8a)+ OpenHarmony Native SDK
QML 语法基线2.12(兼容 Qt 5.12.12;桌面与鸿蒙共享同一份 QML 源文件)
测试Qt Test:SPEC 2.2 全部 12 组向量、4 组断点边界(10 条用例)、NaN/Inf/负数归一化、QObject 属性与窗口监听、旋转几何(中心保持/工作区钳制/正方形/无屏幕)
实测设备HUAWEI MOR-M1(2in1 真机,3120×2080),OpenHarmony 7.0.0.109 / API 26
真机实测1280×730 横屏 large 双栏/侧轨/12 栏(列表单列、详情 760 阅读宽度);窗口旋转 730×1280 竖屏单栏/底栏即时重算;单栏详情与返回正常,选中目标、条目与列表状态保持

构建输出、测试计数和窗口日志抄自验证记录。ctest 输出 1/1 Test #1: tst_tabletlayout 和 Passed 0.99 sec,测试进程报 Totals: 37 passed, 0 failed。

1. 2.15 的 QML 在 5.12 的 qmake 上过不去

桌面那份 AdaptiveTabletWorkspace.qml 第一次进 Qt for OpenHarmony 工程,停在第一行 import:import QtQuick 2.15。预编译 SDK 是 5.12.12,2.15 的文件它不解析。版本号改成 2.12,required property 又报错,那是 5.15 才加的语法。C++ 侧同样断一截:桌面用 QML_ELEMENT 让 CMake 在构建时生成类型注册,5.12 根本不认识这个宏。

这三处与配置无关,是版本基线不同。官方预编译 SDK 只有 5.12.12,没有 qt_add_qml_module(),也没有 QML_ELEMENT。绕开它的办法是把 Qt 6 才有的东西全挤进包装层,不必给鸿蒙抄一份源码:QML 统一写成 2.12 的版本号,Qt 6 也接受;TABLETRESPONSIVE_QML_ELEMENT 在 Qt 6 下展开成 QML_ELEMENT,在 qmake 构建里展开成空,类型改由 plugin.cpp 的 qmlRegisterType() 注册;demo/main.cpp 在 Qt < 5.14 时用 root object 属性回填启动参数。

编译期还撞上一个。桌面 demo 用 setInitialProperties() 传窗口宽高和 --open-first,5.12 的头文件里没有它。现在的写法是一段条件编译:Qt 6 走 initial properties,5.12 在 engine.load() 之后拿 rootObjects().constFirst() 逐个 setProperty()。代价是启动参数在两个时机生效,好处是同一份 demo/ 能同时喂给桌面和鸿蒙。截图回归能过,说明这条兼容路径没有改变渲染:两张预览图重新生成后逐像素比较,差异为空。

布局的输入也吵过一轮。PC 上拖窗口不改方向,折叠屏展开也不触发旋转,QScreen 的方向、窗口宽高、可用区域各说各话。最后的约定只有一句:方向是 width > height 的推导值,布局只认容器尺寸,TabletLayout 不读 screen.orientation。

旋转本身也不省心。resize(交换宽高) 写出来三行,跑起来窗口跳位:左上角不动,中心漂到右下方,多转几次标题栏出屏幕。所以几何被拆成三个 static 函数,Qt Test 不开窗口就能断言矩形,rotate() 只剩"取窗口、调函数、setGeometry"。

2. 跑起来是什么样

示例是"田野笔记"工作台,跑在鸿蒙 2in1 真机的自由窗口里。横屏态:

横屏工作台:侧轨 + 双栏

窗口 1280×730,尺寸提示条汇报 1280 × 730 · 横屏 · large · 12 栏。左侧 88px 深绿侧轨,主体双栏:列表栏限制在 listWidth(300–400)内单列排卡片,详情拿到 760px 的阅读宽度。点左侧卡片只有右侧详情换内容,列表的 GridView 是同一个实例,滚动位置不动。

切到「今天」之后是另一个状态:

切换「今天」后的过滤结果

列表按 item.section == destination.id 过滤,双栏规则是切换目标时选中新目标里最靠前的一项。窗口右上角的「旋转窗口」调用 TabletWindowController.rotate():交换宽高、保持中心、钳制进屏幕可用区域。实机 hilog 里能看到两次几何变化:

windowRectChanged window: Main_QMLTYPE_6 rect: QRect(790,6 730x1350)
window: geometry change to: QRect(790,76 730x1280)

前一行是窗口管理器的中间态,后一行是控制器算完的落地值。布局从 large 双栏重算成 medium 单栏底部导航,选中的目标、条目和列表状态原样保留。

桌面侧的预览图由 demo 自己生成,全部走 --screenshot 参数,后端是 offscreen/software,验证记录再把它们和仓库里的基准做逐像素比较。

3. 布局从窗口尺寸来:resolve() 和它的纪律

整条链路是"窗口 → 绑定 → 纯函数 → QML 属性":

QQuickWindow(拖拽 / 旋转 / 分屏 / 折叠,全部只是宽高变化)
  │  TabletLayout.window 绑定;widthChanged/heightChanged 触发
  ▼
TabletLayout::resolve(width, height, config)   ← static 纯函数,无状态线程安全
  │  sizeClass / columns / margin / gutter / navigation / paneMode / listWidth / density
  ▼
TabletLayout(QML_ELEMENT)                    ← 布局属性投影 + layoutChanged()
  ▼
AdaptiveTabletWorkspace.qml                    ← 零 Controls 的 list-detail 工作台

断点与家族各篇同源,三档加派生规则:

宽度sizeClasscolumnsmargin / gutter
<600compact416 / 8
600–839medium824 / 16
840–1199expanded1232 / 24
>=1200large1240 / 32

导航形态:w >= 840,或 w >= 600 且横屏 → 侧轨;否则底部导航。单双栏:w >= 840,或 w >= 720 且横屏 → 双栏;否则单栏。列表宽度是 clamp(round(w × 0.34), 300, 400),双栏列表强制单列。density 按 h < 500 切紧凑,headerHeight 从 64 变 56。isTablet 只看 min(w, h) >= 600,不封顶 sizeClass:844×390 的手机横屏是 expanded / 12 栏 / isTablet == false。

唯一的实现是 TabletLayout::resolve():

// src/TabletResponsive/TabletLayout.cpp
TabletLayoutMetrics TabletLayout::resolve(qreal width, qreal height,
                                          const TabletLayoutConfig &config)
{
    TabletLayoutMetrics metrics;

    metrics.width = normalizedDimension(width);
    metrics.height = normalizedDimension(height);

    const bool landscape = metrics.width > metrics.height;
    metrics.orientation = landscape ? QStringLiteral("landscape")
                                    : QStringLiteral("portrait");
    metrics.sizeClass = sizeClassFor(metrics.width);
    metrics.columns = columnsFor(metrics.sizeClass);
    metrics.cardColumns = cardColumnsFor(metrics.width, metrics.orientation);
    metrics.margin = marginFor(metrics.sizeClass);
    metrics.gutter = gutterFor(metrics.sizeClass);
    metrics.navigation = navigationFor(metrics.width, metrics.orientation);
    metrics.paneMode = paneModeFor(metrics.width, metrics.orientation);
    metrics.listWidth = std::clamp(
        static_cast<int>(std::lround(static_cast<double>(metrics.width) * 0.34)),
        kListWidthMin, kListWidthMax);

    metrics.railWidth = configDimension(config.railWidth, 88);
    metrics.bottomBarHeight = configDimension(config.bottomBarHeight, 76);

    metrics.density = metrics.height < kCompactDensityHeight
        ? QStringLiteral("compact")
        : QStringLiteral("comfortable");
    metrics.headerHeight = metrics.density == QLatin1String("compact")
        ? configDimension(config.compactHeaderHeight, 56)
        : configDimension(config.comfortableHeaderHeight, 64);

    metrics.isTablet = std::min(metrics.width, metrics.height) >= kTabletMinShortSide;
    metrics.summary = QStringLiteral("%1 × %2 · %3 · %4 · %5 栏")
                          .arg(metrics.width)
                          .arg(metrics.height)
                          .arg(orientationLabel(landscape))
                          .arg(metrics.sizeClass)
                          .arg(metrics.columns);
    return metrics;
}

输入归一化由一个独立的小函数兜底:

// src/TabletResponsive/TabletLayout.cpp
int normalizedDimension(qreal value)
{
    if (!std::isfinite(value) || value <= 0.0)
        return 0;

    const qreal intMax = static_cast<qreal>(std::numeric_limits<int>::max());
    if (value >= intMax)
        return std::numeric_limits<int>::max();

    return static_cast<int>(std::llround(value));
}

normalizedDimension() 先吃掉垃圾输入:NaN、Inf、负数归零,超过 int 上限的钳到 INT_MAX,其余四舍五入。0×0 因此返回 compact 默认值(竖屏、底部导航、单栏、4 栏、16/8、300 宽、紧凑密度、56 头高),不抛异常。窗口初始化、屏幕拔插、容器还没挂载都会短暂量到 0 或非法值,抛异常只会把问题推给调用方。Qt Test 里 resolve(qQNaN(), qQNaN())、resolve(qInf(), -qInf())、resolve(-100.0, -1.0) 各断言了一遍。

resolve() 不读任何成员变量,只读参数和 TabletLayoutConfig。C++ 消费方可以绕开 QML 直接调 resolve(1280, 800),12 组向量、10 条断点用例、归一化和自定义配置也全部离线跑。QML 类型那层只是投影:布局 token 都从同一次 resolve() 的 TabletLayoutMetrics 里读,layoutChanged() 一次性通知,绑定不会出现 orientation 新、paneMode 旧的撕裂帧。TabletLayout.window 只回答"什么时候重算"。

属性这层值得单独说。TabletLayout 挂了 20 个 Q_PROPERTY:15 个只读,4 个可写的尺寸配置,外加一个 window。只读项和 4 个尺寸配置都 NOTIFY layoutChanged,window 单独用 windowChanged。原因在 resolve() 的原子性:一次调用产出的是一份完整快照,orientation、paneMode、listWidth 之间有推导关系;如果每个属性各发 xxxChanged,applyMetrics() 就要逐字段比较、逐字段 emit,漏掉一处,QML 就会拿到半新半旧的状态。现在的写法是整体替换 m_metrics、发一次信号,布局绑定各重算一次。拖动窗口时每帧一次,这个量级在 Qt 里是微秒级的。

也考虑过只暴露一个 QVariantMap layout。QML 里写 layout.paneMode 能跑,但没有类型检查、没有补全,绑定依赖也不好跟踪,每次读还要从 map 里取键。20 个具名属性啰嗦,可 layout.paneMode === "split" 这种写法最直接。布局尺寸里可写的只有 railWidth、bottomBarHeight 和两个 header 高度,它们是宿主可以调的物理尺寸,setter 里做一次 refresh(),复用同一个信号。这套属性最大的好处是可测:纯函数给出快照,QObject 只负责把快照广播出去,Qt Test 断言前者,QML 看到后者,两边不会各算一遍。

setWindow() 除了连接 widthChanged / heightChanged,还连接了 destroyed。窗口销毁时 clearWindow() 把指针置空并重算一次 resolve(0, 0),宿主换窗口或重建窗口时不会读到悬空对象;sync() 在窗口存在时读实际宽高,窗口不在时保留上一次的有效尺寸,setViewportSize() 手动喂进来的值不会被空窗口状态清掉。

4. 旋转:中心保持与工作区钳制

一开始我写的旋转只有三行:取窗口尺寸、交换宽高、resize。跑起来窗口左上角没动,中心漂到右下,多转几次标题栏出屏。setGeometry 以左上角为锚点,交换宽高不会自动保持中心。

旋转的语义是原地转,所以先取当前矩形的中心,再用目标尺寸反推左上角,最后把完整窗口夹进 availableGeometry():

// src/TabletResponsive/TabletWindowController.cpp
QRect TabletWindowController::centeredForSize(const QRect &current,
                                              const QSize &requestedTarget,
                                              const QRect &available)
{
    QSize target(qMax(1, requestedTarget.width()), qMax(1, requestedTarget.height()));

    const qreal centerX = current.x() + current.width() / 2.0;
    const qreal centerY = current.y() + current.height() / 2.0;

    if (!validAvailable(available)) {
        return QRect(qRound(centerX - target.width() / 2.0),
                     qRound(centerY - target.height() / 2.0),
                     target.width(), target.height());
    }

    target.setWidth(qMin(target.width(), available.width()));
    target.setHeight(qMin(target.height(), available.height()));

    const int maxX = available.x() + available.width() - target.width();
    const int maxY = available.y() + available.height() - target.height();
    const int x = qBound(available.x(),
                         qRound(centerX - target.width() / 2.0), maxX);
    const int y = qBound(available.y(),
                         qRound(centerY - target.height() / 2.0), maxY);
    return QRect(QPoint(x, y), target);
}

QRect TabletWindowController::rotatedGeometry(const QRect &current,
                                              const QRect &available)
{
    if (current.isEmpty())
        return current;
    return centeredForSize(current, rotatedSize(current.size()), available);
}

顺序不能换。先按可用区域收缩目标尺寸,再以原中心求位置,最后 qBound 把左上角夹回工作区内。availableGeometry() 优先取窗口当前 screen,拿不到回退主屏,再拿不到返回空矩形;空矩形时 centeredForSize() 走提前返回的分支,只保持中心和尺寸。旁边那个 clampToAvailable() 是给「只想把任意矩形夹进屏幕、不想改尺寸语义」的调用方用的兜底版本。

真机日志里 730×1280 就这么来的:窗口原来是 1280×730,旋转后目标 730×1280,屏幕工作区放得下,于是 x 从中心推回 790、y 落到 76。桌面测试里 keeps-centre 那组 QRect(600,300,800,400) 在 1920×1080 上转成 QRect(800,100,400,800);clamps-both-axes 那组 800×400 在 1000×700 上转成 QRect(600,0,400,700),y 被夹到 0。no-available-rect 的期望值是 QRect(250,-140,400,800),y 是负的——拿不到屏幕信息时保持中心比瞎猜工作区更诚实。

rotatedSize() 只做交换,不管放不放得下;放不下由 centeredForSize() 兜:先把目标宽高压到 available 以内,再按原中心求左上角,最后 qBound 夹回来。测试里 clamps-to-screen 走的就是这条路径:QRect(100,100,1280,800) 在 1920×1080 上旋转,交换得到 800×1280,高度超过工作区,压到 1080,x 按中心换算得 340,y 被夹到 0,结果 QRect(340,0,800,1080)。

所以旋转不保证"转满"。窗口比屏幕高时,转完的宽高就是工作区尺寸,观感上像被压掉一截。库不做缩放补偿,也不改 DPI,只保证窗口完整落在工作区内、中心尽量不跳。真机上 1280×730 能转成 730×1280,是因为工作区高度够;换一块更矮的屏幕,同一个窗口就转不满。

rotate() 的失败路径分三种:没窗口、窗口是正方形、目标尺寸和当前一样。setOrientation() 再加一种:只认 portrait / landscape,其余直接返回 false。方向参数做了 trimmed().toLower(),所以 PORTRAIT 能进,diagonal 返回 false;正方形请求横屏时 target.width() == target.height(),同样返回 false:交换宽高变不出横屏,报没做到比返回自相矛盾的状态好。controllerRotatesWindow() 会真建一个 QQuickWindow,resize(800, 400)、setPosition(20, 20),断言 rotate() 之后的 window.geometry() 等于纯函数算出的值。

5. QML 工作台:同一个 GridView,四条回退规则

AdaptiveTabletWorkspace.qml 的列表从头到尾是同一个 GridView 实例,单双栏靠几何和 visible 切换。选中项和单栏详情开关活在组件状态里,回退规则写在 syncSelectionForMode():

// qml/AdaptiveTabletWorkspace.qml
function syncSelectionForMode() {
    var source = items || []
    var currentValid = false
    if (selectedItemId !== "") {
        for (var i = 0; i < source.length; ++i) {
            if (source[i] && source[i].id === selectedItemId
                    && source[i].section === selectedDestinationId) {
                currentValid = true
                break
            }
        }
        if (!currentValid)
            selectedItemId = ""
    }

    if (split) {
        singleDetailVisible = false
        if (selectedItemId === "") {
            var first = firstItemId(selectedDestinationId)
            if (first !== "")
                selectedItemId = first
        }
    } else if (selectedItemId === "") {
        singleDetailVisible = false
    }
}

function selectDestination(destinationId) {
    if (selectedDestinationId === destinationId)
        return
    selectedDestinationId = destinationId
}

function openItem(itemId) {
    var source = items || []
    var found = false
    for (var i = 0; i < source.length; ++i) {
        if (source[i] && source[i].id === itemId) {
            found = true
            break
        }
    }
    if (!found)
        return
    selectedItemId = itemId
    if (!split)
        singleDetailVisible = true
}

function backToList() {
    singleDetailVisible = false
}

选中项是否合法要连 section 一起校验:切到"归档"之后,原来在"收件箱"里选中的条目不该继续占着详情位。onSplitChanged 缩回单栏时先把 singleDetailVisible 置 false 再调 syncSelectionForMode(),所以双栏缩回单栏一定回到列表;反过来单栏展开双栏时保留合法选中项,没有就补上最前面那一项。openItem() 在单栏里多置一次 singleDetailVisible = true,返回按钮只在单栏渲染。

列表卡片列数在运行时算,cellWidth 是整宽除以列数,不把尾部 gutter 算进去。这里踩过一次:GridView 用 floor(width / cellWidth) 决定列数,如果给 cell 加上尾部 gutter 再除,2 列会退化成 1 列。cardColumnCount 在 split 模式恒为 1,只有 single 模式才用 layout.cardColumns,所以双栏时列表永远是单列,详情拿剩余宽度。

数据侧还有个规矩:destinations / items 必须是 JS 数组,更新时整个替换,原地 push 触发不了 onItemsChanged,QML 的绑定通知只认引用变化。headerAction 是个 Component 插槽,demo 的旋转按钮由它注入。

6. 两条链怎么包同一份源码

源码只有一份,src/ 与 qml/ 是共享内核:

qt/                                 # 库根目录(CMakeLists.txt,v1.0.0)
├─ src/TabletResponsive/            # TabletLayout + TabletWindowController
├─ qml/AdaptiveTabletWorkspace.qml  # list-detail 参考工作台(2.12 语法)
├─ demo/                            # main.cpp + Main.qml + demo-data.json + 截图参数
├─ tests/tst_tabletlayout.cpp       # 12 向量 + 边界 + 属性 + 旋转几何
├─ cmake/TabletResponsiveConfig.cmake.in
└─ ohos/                            # Qt for OpenHarmony 工程(DevEco 可直接打开)
   ├─ library/                      # HAR:libTabletResponsiveplugin.so + resfile/qml/TabletResponsive/
   ├─ example/                      # 演示 HAP:QAbility 桥接 + libtabletadaptivedemo.so
   ├─ qt/{plugin,demo}.pro          # qmake 交叉编译(复用同一份 src/ 与 demo/)
   └─ build-qt-ohos.sh              # 交叉编译 + 部署 + 打包 + 安装 + 启动

桌面与鸿蒙两条构建链的目录结构

桌面上,src/CMakeLists.txt 用 qt_add_qml_module() 把 C++ 类型和 QML 文件编成一个模块,类型注册由构建系统生成,QML 模块先落在构建树的 qml/ 下,安装时进 lib/qml/TabletResponsive/。鸿蒙这条链没有这套东西,于是有一个小插件把 TabletLayout 和 TabletWindowController 注册回去:

// ohos/qt/plugin.cpp
#include <QtQml/QQmlExtensionPlugin>
#include <QtQml/qqml.h>

#include "TabletResponsive/TabletLayout.h"
#include "TabletResponsive/TabletWindowController.h"

class TabletResponsivePlugin : public QQmlExtensionPlugin
{
    Q_OBJECT
    Q_PLUGIN_METADATA(IID QQmlExtensionInterface_iid)

public:
    void registerTypes(const char *uri) override
    {
        Q_ASSERT(QLatin1String(uri) == QLatin1String("TabletResponsive"));
        qmlRegisterType<TabletLayout>(uri, 1, 0, "TabletLayout");
        qmlRegisterType<TabletWindowController>(uri, 1, 0, "TabletWindowController");
    }
};

#include "plugin.moc"

plugin.pro 负责把它编成 libTabletResponsiveplugin.so,关键几行是 CONFIG += plugin c++17、DEFINES += TABLETRESPONSIVE_LIBRARY TABLETRESPONSIVE_QMAKE_PLUGIN、INCLUDEPATH += ../../src,以及 CONFIG += no_qt_rpath。这行不能省:一开始交叉编译出来的 .so 里写着开发机的 Qt 安装路径,装到设备上 loader 找不到 libQt5Quick.so,报错信息还指向开发机用户目录下的 ohos-frameworks/qt/lib。关掉之后 llvm-readelf -d 里的 RPATH / RUNPATH 是空的,Qt 依赖改由宿主 HAP 的 libs/arm64-v8a 解析。demo.pro 更短,但有一个容易漏的宏:它用 DEFINES 把设备上的 QML import 根(/data/storage/el1/bundle/entry/resources/resfile/qml)编进 TABLET_RESPONSIVE_QML_IMPORT_DIR,main.cpp 读到非空就 engine.addImportPath();桌面构建里宏是空串,这段被跳过。

部署是 ohos/build-qt-ohos.sh 一条脚本走完:qmake 编 plugin 和 demo,产物分别进 HAR 的 library/libs/arm64-v8a/ 与 resfile/qml/TabletResponsive/,同时镜像一份进宿主 HAP 的 example/libs/arm64-v8a/ 与 example/src/main/resources/resfile/qml/,--hap 调 hvigor,--install 装,--run 起 QAbility。参数全部来自环境变量,换机器只改变量。两边各放一份 QML 目录,是因为 HAR 的 resfile 会不会随包传给宿主取决于 hvigor 版本,脚本不赌这个行为。

两边的差别可以列成一张很小的对照清单。QML 模块注册:桌面由 qt_add_qml_module() 生成 qmldir、qmltypes 和插件注册代码,鸿蒙由 plugin.cpp 的 qmlRegisterType() 加手写的 ohos/qt/qmldir。C++ 标准:两边都是 C++17,一个来自 CMAKE_CXX_STANDARD 17,一个来自 CONFIG += c++17。头文件路径:一个走 target_include_directories 的 PUBLIC 参数,一个走 INCLUDEPATH += ../../src。安装布局:一个进 include/、lib/、lib/qml/,一个进 HAR 的 libs/arm64-v8a/ 与 resfile/qml/。demo:桌面是可执行文件,鸿蒙必须编成 libtabletadaptivedemo.so,由 libqohos.so 调 main。五处差异全在包装层,src/ 与 qml/ 没有分叉。同一个故障在桌面上复现不了,基本就能确定出在部署脚本。

7. 类型注册、签名与包里的载荷

语法基线定下来之后,桌面也不能用 Qt 5.15 之后的新 QML 特性写库代码,required、inline component 全部放弃。类型注册清单还要两边同步:TABLETRESPONSIVE_QML_ELEMENT 在 qmake 构建里展开成空,只加头文件里的宏、忘了 plugin.cpp 的 qmlRegisterType(),结果就是桌面编得过、鸿蒙运行时找不到类型。plugin.cpp 顶部那句 keep both lists in sync 是写给以后的自己看的。

旋转跳位那次前面说过,resize(交换宽高) 让中心漂移。改用 rotatedGeometry() 之后还有个尾巴:setGeometry() 传进去的尺寸不一定就是落地尺寸,窗口管理器可能取整或者套最小尺寸限制。所以 orientationChanged() 在 setGeometry() 之后才发,orientation() 读的是 m_window->width() / height(),QML 拿到的是窗口管理器落地后的实际尺寸,不是请求值。

窗口出屏也撞过一次。标题栏拖出屏幕之后鼠标够不着,只能用键盘救回来。夹取优先于中心保持就是那次定下来的:宁可中心偏移,也不让窗口有一角留在工作区外。

剩下两个都是安装布局问题。图省事把 qmldir 塞进 Qt 安装目录,升级 Qt 即失效,多版本共存互相污染;现在模块装在 lib/qml/TabletResponsive/,TabletResponsiveConfig.cmake 导出 TabletResponsive_QML_IMPORT_DIR,宿主自己 addImportPath()。add_subdirectory 默认会把 demo 和测试编进宿主,CI 平白多拉 Qt Test;现在两个选项顶层默认 ON、作为子工程默认 OFF(${PROJECT_IS_TOP_LEVEL})。

鸿蒙侧的坑更偏工程。装 HAP 时只装了 qEmbeddedUiExtensionHost,启动器里有图标、点进去没反应——QAbility 在 entry 里,两个 HAP 都要装,DevEco 的 Run Configuration 也要选 entry。签名是另一个:本机 profile 绑的是别的 bundleName,直接套会安装失败,得把 AppScope/app.json5 的 bundleName 改成 profile 里的那个。本机签名放在 gitignored 的 ohos/build-profile.signed.local.json5,--hap/--install/--run 时临时覆盖 build-profile.json5,trap 配合 EXIT 保证失败退出也还原。

还加了一道载荷保护。手工跑 hvigorw assembleHap 而没先跑部署脚本时,example/libs 是空的,打出来的 HAP 里没有 libqohos.so,装上去白屏。现在 check_qt_payload 这个自定义 target 会在 example/libs/arm64-v8a 或 resfile/qml/TabletResponsive 缺失时让 BuildNativeWithNinja 直接失败,日志停在 FAILED: CMakeFiles/check_qt_payload,最后一行是 > hvigor ERROR: BUILD FAILED。

这条验证是故意制造的:把 example/libs 改名成 libs.bak 再构建,确认它失败,改回来才成功。

8. 宿主怎么接,还有哪些没验证

工程本身由布局引擎、窗口控制器和 QML 工作台三块组成,版本 1.0.0,Apache-2.0。桌面有三种接入方式:

# 1. CMake 安装 + find_package
cmake -S . -B build -DCMAKE_PREFIX_PATH="<Homebrew 前缀>" -DCMAKE_INSTALL_PREFIX="$HOME/.local"
cmake --build build -j8 && cmake --install build
# 宿主:find_package(TabletResponsive 1.0 CONFIG REQUIRED)

# 2. add_subdirectory(demo/tests 默认 OFF)
# 3. 只用 C++ 引擎:#include <TabletResponsive/TabletLayout.h>

QML 侧的最小宿主长这样,数据来自 demo-data.json,旋转按钮走 headerAction 插槽:

// 参考 demo/Main.qml 的最小宿主;demoData 由 main.cpp 注入
import QtQuick 2.12
import QtQuick.Window 2.12
import TabletResponsive 1.0

Window {
    id: root
    width: 1280
    height: 800
    visible: true

    TabletWindowController { id: rotation; window: root }

    AdaptiveTabletWorkspace {
        anchors.fill: parent
        window: root
        title: demoData.brand
        eyebrow: demoData.eyebrow
        destinations: demoData.destinations
        items: demoData.items
        showMetrics: true

        headerAction: Component {
            Rectangle {
                width: 120
                height: 44
                radius: 14
                color: "#16352E"

                Text {
                    anchors.centerIn: parent
                    text: "旋转窗口"
                    color: "#F4F1E9"
                }

                MouseArea {
                    anchors.fill: parent
                    onClicked: rotation.rotate()
                }
            }
        }
    }
}

跑 demo 与测试:

cmake --build build -j8 && ctest --test-dir build --output-on-failure
./build/demo/tablet-responsive-demo                    # 1280×800 + 旋转按钮
QT_QPA_PLATFORM=offscreen QT_QUICK_BACKEND=software \
  ./build/demo/tablet-responsive-demo --screenshot preview.png --delay 1200

鸿蒙侧一条脚本(参数走环境变量):

cd ohos && ./build-qt-ohos.sh --hap --install --run
# 交叉编译 → 部署 HAR/HAP → hvigor 打包 → hdc 安装 → 启动 QAbility

hvigor 打包的载荷里,插件 56,064 字节、demo 35,256 字节、qmldir 144 字节、AdaptiveTabletWorkspace.qml 56,550 字节。unsigned HAP 28,096,233 字节,签名版 28,462,723 字节。两个 HAP 都装上之后,hdc shell aa start -a QAbility -b dev.cjgg.tablet_responsive_example 能起。

更完整的 API 表、安装布局与载荷校验在仓库文档里:仓库说明记 QML 用法、TabletLayout / TabletWindowController 全属性表和接入方式;OpenHarmony 接入说明记 Qt 5.12.12 基线、交叉编译命令与边界说明;验证记录与包检查记录收着构建、测试、实机全记录,以及安装目录和 HAR/HAP 载荷校验。

布局并不依赖 TabletWindowController。最大化、全屏、分屏的窗口由窗口管理器接管时,rotate() 的 resize 请求可能被拒绝,布局照样跟着实际容器尺寸走。当前的验证边界:桌面 Qt 6.11.0 + CMake 4.3.2 上构建、37 个用例、截图逐像素比对都过;鸿蒙 Qt 5.12.12 交叉链能编译出 aarch64 ELF、打出 HAP、在 2in1 浮动窗口里完成一次 1280×730 → 730×1280 的旋转;Qt 6 的 OHOS 交叉编译没做过,全屏下 rotate() 会不会被窗口管理器接受也没有结论。接下来补这两处。

相关推荐

React Native 鸿蒙长列表优化实战:用静态审计加运行时探针守住 FlatList 的四条底线

本文提出并实现了一套针对 React Native 长列表的“双层守卫”机制:静态审计(7 条反模式规则,可集成 CI)与运行时渲染探针(renderItem 采样 + rAF 帧间隔归因)。通过在 OpenHarmony 模拟器上对 400 行数据的实测对比,验证了 ScrollView+map 方案在首帧、内存、滚动上的显著劣势,而优化后的 FlatList 虚拟化方案有效降低视图常驻与维护成本。工具链已开源,支持快速定位问题、自动化拦截劣质代码,提升长列表性能与可维护性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 27

Cordova 鸿蒙空间音频实战:让网页里的声音“绕着头转“

本文通过一个零原生代码的纯JS Cordova插件,实证解答了WebView中“真”空间音频的可行性:基于ArkWeb(Chromium内核)的Web Audio API,HRTF卷积空间化可原生支持,采样率48kHz,延迟仅108ms。插件以一行ArkTS未写的方式,实现跨平台空间音频合成,通过探测机制动态降级,并解决纯JS插件注入hcordova宿主的兼容难题。效果验证显示方位角拖动与理论值高度一致,揭示了前后镜像等物理边界。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 34

ReactNative鸿蒙实况窗实战:让订单状态“跟着JS走“

本文以 React Native 0.84 + RNOH 0.84 为基底,详解实况窗发布链路的六跳桥接机制:从 JS 侧纯 TS 构造 payload(①),经 JSON 序列化(②),通过手写 JSI 胶水(③)跨至 ArkTS,由 TurboModule 解析并注入 wantAgent(④),最终调用 liveViewManager 发布。全程依赖 hilog 逐跳验证,确保字段、序列号、耗时精准对齐。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 35

Cordova鸿蒙实况窗实战:让实况窗卡片“长在网页里“

在鸿蒙Cordova环境下,通过纯JS实现“零原生”实况窗预览:将payload构造层与预览器完全剥离原生依赖,利用DOM渲染实现胶囊与卡片的0.5ms级高效更新。依托esbuild打包与UMD注入,三端同构状态机精准映射HMS kits字段,probe()明确标识沙箱不支持HMS kits的边界。实测显示,外卖、打车、比分场景的动态切换与左滑分享交互均可在页面内完整模拟,验证了纯前端方案在能力边界内的可行性与高性能表现。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 32

Cordova 鸿蒙渲染耗时实战:给 ArkWeb 容器装上 FCP、长任务和构建期审计的三只眼

本文针对Cordova应用在OpenHarmony上的渲染性能问题,提出“三层探针”方案:通过javaScriptOnDocumentStart注入PerformanceObserver采集页面指标(FCP、LCP、longtask),ArkTS插件记录容器加载耗时(onPageStart→End),构建期审计器扫描www/识别布局抖动、同步读写几何等反模式。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 43

Qt 鸿蒙电脑多屏适配:拔掉外接屏,窗口怎么回到主屏?

本文介绍基于Qt的鸿蒙跨平台窗口恢复方案,针对外接屏拔插导致窗口坐标异常问题,提出“屏幕接力”机制。通过判断屏幕是否存在、计算窗口在目标屏的可见区域,实现窗口自动回主屏。核心逻辑包括:动态检测屏幕变化,优先使用同名屏或主屏作为目标,结合qBound确保窗口尺寸与位置在可用区内,并通过延迟回调避免状态冲突。实测验证了单屏环境下窗口恢复的正确性,强调需双屏环境进一步验证热拔插与重启场景下的兼容性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 59

React Native 接入鸿蒙推送:冷启动工单路由与令牌排查

本文基于HarmonyOS跨平台开发框架RNOH,通过真机与模拟器实测验证工单推送功能。重点分析冷启动与热启动下路由参数传递、推送令牌获取(返回1000900010)及重复入口处理机制。实验表明:原生侧缓存工单号,React Native就绪后通过轮询接收,有效避免事件丢失;重复发送相同工单不增加计数,确保状态一致性。建议后续结合Push Kit服务配置与调试Profile完成完整推送链路验证。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 78

Ionic 接入鸿蒙应用 Skill:两件耗材同名时,先确认库位再查询

本项目基于鸿蒙跨平台框架,实现Ionic应用与ArkTS查询逻辑的统一,验证“问得少、答得准”策略:同名物料先返回候选库位,用户确认后才显示数量;唯一命中则直接返回结果。通过真实设备与模拟器测试,确保状态管理正确,取消后可重查,提升交互效率。代码复用性强,适用于多端一致的库存查询场景。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 38

Cordova 电量插件重订阅:为什么第二轮收不到当前电量?

本文分析了OpenHarmony跨平台Cordova电量插件在MatePad Edge设备上的订阅问题:原版插件停止后重启无法接收新电量状态,原因在于JS层缓存旧值导致同值过滤失效。修复方案为在首次订阅时重置_level和_isPlugged状态,确保每轮订阅都能收到初始值。测试验证修正版在真机与模拟器上均能稳定触发每轮状态回调,且不影响原有去重机制。关键点在于区分“当前值”与“变化通知”,并明确生命周期管理,避免因状态残留影响新订阅。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 29

Ionic 接入鸿蒙日历:会议改期两次,系统怎么只保留一条?

本文通过真实设备测试,验证了在鸿蒙系统中跨进程重启后,应用能否正确识别并更新同一日历事件。核心在于使用固定业务标识(identifier)而非标题或时间匹配事件,确保改期、重启、删除等操作均能准确追溯同一记录。测试显示,两次改期后事件ID保持不变,重启后仍可找回原事件,证明系统未误触发新增。同时强调:仅靠回读结果判断写入是否成功,需同步核对条数、事件ID与时间,避免因状态不一致导致逻辑错误。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 34

React Native 在鸿蒙读取 EXIF:三张 JPEG 能读出哪些信息?

本文基于HarmonyOS跨平台开发实践,实现React Native与ArkTS间EXIF信息读取的原生桥接。通过三张预设样片(含时间、坐标、空标签)验证了在MatePad Edge真机及模拟器上对拍摄时间与GPS坐标的准确读取能力,结合Pillow独立回读校验,确认字段缺失由原生层统一归零处理。桥接层采用逐项请求策略,避免因部分字段缺失导致整体解析失败,并通过默认值收敛机制返回null,便于前端区分“无数据”与“解析异常”。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 36

React Native 接入鸿蒙 OCR:双栏讲义怎么读才不串行?

本文基于OpenHarmony与React Native跨平台框架,实现双栏讲义的智能OCR阅读排序。通过保留原始识别框坐标,对比“按纵坐标”与“按列阅读”两种策略,验证后者在保持语义顺序上的优势。实验表明,仅依赖纵坐标易因行框位置微小偏差导致错序,而按栏分组后按纵坐标排序可准确还原人工参考顺序(10/10匹配)。系统通过中缝判断跨栏行,结合原图像素坐标与缩放比例,确保界面高亮精准对应。代码设计强调坐标完整性与逻辑分离,支持后续版面自适应优化。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 23

Ionic 接入鸿蒙文档扫描:三页巡检单怎么合成一份 PDF?

「折页扫描」应用通过鸿蒙系统编辑器实现PDF文档的删页、旋转与导出。测试中,四张样张(封面、作废附件、检查表、签核页)经编辑后生成3页正向PDF,文件大小178,479字节,内容与预期一致。关键在于:系统编辑器返回的PDF由实际操作结果生成,而非重新构造原始图像;通过pdfinfo与逐页渲染验证页数与方向,确保交付成果准确可复现。插件回调机制保障流程唯一性,避免并发问题,实现端到端可信交付。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 23

Ionic 接入鸿蒙文搜图:应用重启后,搜索结果还能打开原图吗?

本文通过鸿蒙跨平台项目演示图像搜索与文件读取的完整链路:使用Capacitor调用原生Vision Kit进行文本搜索,结果仅传递图片ID至Ionic页面,点击时由原生侧根据沙箱路径读取文件。实测验证了重启、进程强制结束、文件移除等场景下的行为,强调索引与文件存储分离的重要性,确保“搜索可查、打开可读”。关键点包括:避免同名覆盖、持久化标识映射、点击时二次校验文件存在性,以及合理处理空结果与文件丢失的差异反馈。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 26

Cordova 接入鸿蒙主体分割:商品图怎么导出成透明 PNG?

本文记录一个 Cordova 商品图工作台在鸿蒙 MatePad Edge 上的实测:选图后调用系统主体分割,把前景编码为 PNG,网页用离屏 Canvas 重读 Alpha 校验透明度,再由系统文件选择器原样落盘。核心结论是预览与导出共用同一份字节,文件是否透明只由独立解码后的 Alpha 决定,而非棋盘格预览。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 27

Electron 鸿蒙媒体实战:打通小艺 Skill 与 Agent 语音指令,TCP 桥实现 Electron 跨端语音操作闭环

本文探讨了在鸿蒙系统上运行 Electron 应用时,实现小艺语音交互的“三个世界”挑战:渲染进程、主进程与宿主 UIAbility 间无共享运行时。通过回环 TCP 桥接方案,将 ArkTS 的 ASR/TTS 能力与 Electron 的媒体控制逻辑打通,实现指令路由与执行仲裁。采用统一意图目录(纯规则 NLU),支持桥在线时由 Electron 执行,离线时自动切换原生兜底。实测验证了真机闭环协议,展示了从语音输入到播报反馈的完整链路,为跨平台语音代理提供可复用架构。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 52

Qt 鸿蒙日历读写实战:Qt Widgets 通过 JS 桥打通 C++ 与 ArkTS CalendarKit,封装 qt-ohos-calendar 三方库,解决同步调用与异步 Promise 矛

Qt应用在鸿蒙上实现日历互通,面临Qt C++与ArkTS系统日历接口隔离问题。通过封装qt-ohos-calendar库,利用Qt for HarmonyOS自带的JS桥(QOhosJsThreadGateway),将同步调用转为异步处理:Qt侧以QObject定义接口,ArkTS侧通过串行队列收敛Promise,实现权限申请、日历创建、事件增删改查等操作,并借助快照轮询机制确保状态一致。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 40

KMP 鸿蒙日历:Kotlin/Native 内核 + NAPI 桥接 CalendarKit 实战

Kotlin Multiplatform 在鸿蒙上实现日历功能面临“三层世界”挑战:业务逻辑(事件归一化、RRULE处理)由Kotlin/Native负责,系统日历调用通过ArkTS的CalendarKit完成,中间依赖NAPI胶水层仅传递JSON字符串。项目通过自研KMP工具链(CPF-KMP-CMP)构建ohosArm64/x64双目标.so,并封装为HAR库,确保胶水层最小化、不感知业务字段。实测验证了权限申请、跨进程读写、周期规则转换等核心流程,日志与系统日历联动,证明方案可行。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 23

Qt 鸿蒙沉浸光感实战:同一份规格对接双渲染器,打通 Qt 与 ArkUI 跨运行时通道,搞定系统玻璃材质、Qt 自绘对齐

本文聚焦Qt for HarmonyOS中玻璃效果的跨运行时对齐问题,提出“单一事实来源”方案:将材质参数表(五档模糊、赋色、高光等)封装为C++17内核,供Qt与ArkTS共享。通过napi_threadsafe_function实现跨线程请求/回调,确保弹窗、菜单等系统组件使用真实材质,同时自绘玻璃与系统风格一致。实测验证参数可测量、闭环可控,关键链路如overlay.show→dismissed完整无损,最终达成“同一规格,双渲染器”的沉浸式体验统一。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 51

打通 CMP 与鸿蒙系统智能:三方库承载语音匹配、TTS 播报、小艺 Agent 调用与意图回调全链路

本文通过 cmp_ohos_ai_agent 库,详解 Kotlin/Compose Multiplatform 如何实现鸿蒙小艺语音闭环。从技能注册、麦克风输入到 TTS 回话,再到反向接收系统意图与调起智能体组件,揭示跨端框架与 ArkTS 间双向桥接的实现机制。结合真机实测(华为 nova 14),展示能力探测、设备状态同步、指令匹配与执行回执全流程,并解析权限、组件不可渲染等关键坑点,验证了在 CMP 下完成完整语音智能交互的可行性。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 43

Qt for HarmonyOS 语音智能体落地:qt-ohos-ai-agent 三方库实现本地指令与小艺双向联动,拆解 NAPI 桥接

本文探讨了在鸿蒙系统上运行Qt应用时,如何实现语音指令闭环——将Qt Widgets界面与鸿蒙原生语音能力(CoreSpeechKit、textToSpeech、AgentFrameworkKit、InsightIntent)深度融合。通过构建三层架构:纯C++17核心(解析+状态机)、ArkTS HAR模块(语音/播报/小艺调用)、Qt服务类(JS桥接),实现“应用内说话”与“对小艺说话”共享同一套语义理解大脑。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 36

KMP 鸿蒙空间音频与智能体落地:绕开 JS 桥阻塞,OHAudio 原生渲染,小艺语音指令实现声场动态重排

本文探讨了在Kotlin Multiplatform(KMP)开发鸿蒙应用时,实现“媒体+AI”闭环的挑战与解决方案。核心难点在于音频渲染需在系统音频线程中实时执行,而小艺语音识别、合成及AgentFrameworkKit仅支持ArkTS,导致KMP难以直接调用。作者通过cinterop暴露libohaudio.so接口,将音频处理逻辑下沉至Kotlin/Native,确保低延迟;同时将意图识别、声场重构等核心算法全量移入commonMain,实现纯Kotlin闭环。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 75

CMP 鸿蒙日历读写实战:Compose 月历跨 Kotlin/C/ArkTS 桥接 CalendarKit,自建独立日历账户

本文详解了在鸿蒙CMP(Compose Multiplatform)环境下实现跨语言日历读写的完整链路:Kotlin通过C API头文件与ArkTS via NAPI桥接,以字符串通道传递id, op, argsJson指令,实现权限感知的本地/系统日历降级存储。核心突破在于将CalendarKit封装为CMP库,利用协程挂起-恢复机制完成异步通信,并确保日程写入自建日历账户(如“CMP日历”),最终在系统日历中可见且归属明确。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 95

CMP 鸿蒙沉浸光感实战:弹窗菜单复用系统材质,自绘画布按算力档位对齐,打通 CMP 与 ArkUI 双轨渲染链路

本文通过一个跨端示例工程,深入解析鸿蒙API 26中ImmersiveMaterial的底层机制:它并非普通贴图,而是仅作用于特定系统组件(如弹窗、菜单)的“系统材质”,具备档位分级、算力降级与生效范围限制。文章揭示了如何在CMP框架中封装该能力——将弹窗/菜单壳交还ArkUI实现真材质,自绘内容则通过标定参数模拟其模糊、着色、光效等特征,确保在模拟器与真机上视觉对齐。项目已开源,提供完整实现与社区支持。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 74

Electron 鸿蒙系统级 TTS 实战:把声音交给操作系统,把队列留给自己

本文探讨在 Electron 与 HarmonyOS 上实现“系统级 TTS”的挑战与解决方案。Electron 因主进程无渲染环境,需通过 1×1 隐藏 renderer 托管 speechSynthesis;鸿蒙则受限于 Core Speech Kit 的接口约束,如无暂停、边界事件等。二者均采用文本分块队列与请求唯一标识管理长文本播报。代码已开源,展示跨平台系统语音集成的实践路径。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 130

KMP 鸿蒙系统级 TTS 实战:让队列里的每一句都说完整

本文基于鸿蒙2in1平台,通过KMP工程实现一个离线TTS合成引擎,解决平台回调两次、事件乱序、资源复用等难题。核心在于:以ArkTS为入口,Kotlin负责队列与状态机,统一归一化平台回调,确保“合成完成”与“播放完成”精准区分;通过requestId管理请求生命周期,支持抢占与过期事件丢弃,保障多任务有序执行。实测24项JVM用例全通过,状态机稳定可靠,适用于无障碍朗读、订单播报等离线语音场景。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 186

Cordova 鸿蒙系统级 TTS 实战:让 WebView 里的文字“开口说话“

本文以鸿蒙7.0真机实测为例,剖析Cordova插件cordova-plugin-tts-ohos从JS调用到系统TTS引擎的完整链路:通过一层C++桥接实现JS与ArkTS通信,依托Core Speech Kit完成离线语音合成。重点揭示“384ms播完”截图的误导性——实际为合成完成而非播放结束,修复后耗时达9.2秒,强调onComplete.type区分合成与播放终态的重要性。同时说明事件流需保留keepCallback状态,确保Promise在真正播放结束后才resolve,避免竞态。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 217

Qt 鸿蒙系统级 TTS 实战:让 QML 借系统的嗓子说话

本文基于 Qt 5.12.12 与 HarmonyOS,通过一个 QML 插件(SpatialTts)实现跨平台系统级 TTS:桌面调用 Qt TextToSpeech,鸿蒙对接 Core Speech Kit。核心创新在于将队列、状态管理与音色控制统一于 Qt 侧,后端按编译期选择,鸿蒙端通过 JS 线程桥(QOhosJsThreadGateway)调用 ArkTS 接口,并完成宿主注册。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 202

React Native 鸿蒙系统 TTS 实战:让表面开口

本文介绍了一个基于 React Native 0.84 的鸿蒙三方库 spatial-glass-rn,实现系统离线 TTS 语音播报的全链路集成。通过拆解长文本分段、JS 侧队列管理、跨平台事件归一化与状态同步,将系统级语音引擎(鸿蒙 Core Speech Kit)与光感表面视觉组件融合,构建出无网络依赖、零额外体积、隐私安全的语音交互体验。真机实测验证了在仓储、巡检等场景下的稳定性与实时性,解决了三端语义不一致问题,实现了“状态可读、进度可视、操作可控”的沉浸式语音反馈。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 220

React Native 鸿蒙端侧 AI 图像超分实战:让 NPU 把细节补回来

本文详解在鸿蒙PC上基于React Native 0.84的react-native-ohos-ai-vision库,实现512px图像通过NPU进行4倍超分并返回JS的完整链路。核心突破在于:通过显式引擎标识(engine字段)与可验证校验和,区分AI(Core Vision Kit/NPU)与CPU双三次回退路径,确保结果可信。实测证明,仅当factor=4且API≥26时启用NPU,否则自动降级至确定性双三次算法,全程无网络依赖,端到端耗时约3.6秒,效果真实还原细节。

白天写代码,晚上追AI大模型,偶尔搞点八卦 开源动态|技术干货|实习机会|生态活动 我负责分享,你负责变强 181
上一篇: Qt 鸿蒙端侧 OCR 实战:当系统 API 只给了 ArkTS 入口
下一篇: Flutter 鸿蒙圆屏穿戴实战:让信息学会自己降级
AtomGit 代码君
AtomGit 代码君 企业官方账号 企业官方账号
博客等级 码龄6年 2万+粉丝 986原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值
⌂ 换网址