HarmonyOS 鸿蒙Next团结引擎交互

背景说明

当前关于团结引擎与鸿蒙系统通信的开发资料较为零散，官方文档存在不匹配情况。本文旨在提供一个完整的开发实例，帮助开发者快速实现团结引擎与鸿蒙系统的通信功能。

环境配置

最新版团结引擎已自动配置OpenHarmony SDK路径，无需手动设置。

关键开发要点

1. 鸿蒙插件目录结构

• 必须在Assets目录下创建Plugins/OpenHarmony文件夹存放插件

2. 注册函数规范

注册函数命名格式必须为：“Register”+插件名称

基本示例：

export class ClassObjectTest {
  intFunc(a, b) {
    return a + b;
  }
}

export function RegisterTestClass() {
  var register = {}
  register["ClassObjectTest"] = new ClassObjectTest();
  return register;
}

3. 文件类型注意事项

官方文档存在两个版本说明：

• 插件可使用.tslib、.ts或.ets扩展名，但必须放在Plugin/OpenHarmony目录下
• 在Plugins/OpenHarmony下可创建.etslib插件导出类，并能直接引入.ets文件

实际开发建议：

• 使用.etslib作为插件主文件
• 将业务类分离到.ets文件中
• 在.etslib文件中进行注册

4. 通信实现方案

团结引擎提供了两种与鸿蒙通信的方式：

方案一：Callback回调方式（推荐）

Unity端代码：

using UnityEngine;

class CallbackScript : MonoBehaviour
{
    private void Start()
    {
        OpenHarmonyJSObject openHarmonyJSObject = new OpenHarmonyJSObject("ClassObjectTest");
        OpenHarmonyJSCallback Callback = new OpenHarmonyJSCallback(CallbackFunc);
        openHarmonyJSObject.Call("intFunc", Callback);
    }

    private string CallbackFunc(params OpenHarmonyJSObject[] args)
    {
        if(args.Length == 0 || args[0] == null) {
            return "{\"error\":\"Invalid arguments\"}";
        }
        OpenHarmonyJSObject result = args[0]; 
        Debug.Log($"CallbackFunc: {result.Get<int>("value")}");
        return "{\"status\":\"success\"}";
    }
}

鸿蒙端代码：

ClassObjectTest.ets

import { hilog } from '@kit.PerformanceAnalysisKit';
import { Callback } from '@kit.BasicServicesKit';

interface CallBackInterface {
  value: number;
}

export class ClassObjectTest {
  test(): Promise<number> {
    hilog.info(0xFF00, "测试11:", `${JSON.stringify(globalThis.context)}`);
    return new Promise(resolve => {
      hilog.info(0xFF00, "测试,调用promise函数:", '执行test');
      resolve(666)
    })
  }

  async intFunc(callback: Callback<CallBackInterface>) {
    const result = await this.test();
    callback({ value: result as number });
  }
}

TestClass.etslib:

import { ClassObjectTest } from './ClassObjectTest';

export function RegisterTestClass(): ESObject {
  let register: ESObject = {}
  register["ClassObjectTest"] = new ClassObjectTest();
  return register;
}

方案二：tuanije.so发送message（我们unity开发说不推荐,如果有需要不好找的可以回帖我再加上）