HarmonyOS

YourProject/
├── AppScope/
├── entry/                      # 业务模块
├── libxmagic/                  # ← 本 HAR 模块
│   ├── libs/arm64-v8a/         # SDK 静态库 + .so
│   ├── src/main/cpp/           # NAPI 桥接源码
│   ├── src/main/ets/           # ArkTS 封装
│   └── oh-package.json5
├── build-profile.json5
└── oh-package.json5

{
  "modules": [
    { "name": "entry",     "srcPath": "./entry"     },
    { "name": "libxmagic", "srcPath": "./libxmagic" }
  ]
}

{
  "dependencies": {
    "libxmagic":    "file:../libxmagic",
    "libxmagic.so": "file:../libxmagic/src/main/cpp/types/libxmagic"
  }
}

"abiFilters": ["arm64-v8a"]

"requestPermissions": [
  { "name": "ohos.permission.CAMERA", "reason": "$string:camera_reason",
    "usedScene": { "abilities": ["EntryAbility"], "when": "inuse" } },
  { "name": "ohos.permission.INTERNET" }   // license 在线鉴权需要
]

import { fileIo as fs } from '@kit.CoreFileKit';
import { zlib } from '@kit.BasicServicesKit';
import { common } from '@kit.AbilityKit';

private async ensureLightCoreBundle(): Promise<string> {
  const ctx = getContext(this) as common.UIAbilityContext;
  const filesDir = ctx.filesDir;
  const bundleDest = filesDir + '/res';
  const zipDest    = filesDir + '/res.zip';

  if (fs.accessSync(bundleDest)) {
    return bundleDest;                 // 已解压，直接复用
  }

  // 1. rawfile → 沙箱临时文件
  const zipBytes: Uint8Array = await ctx.resourceManager.getRawFileContent('res.zip');
  const f = fs.openSync(zipDest, fs.OpenMode.WRITE_ONLY | fs.OpenMode.CREATE | fs.OpenMode.TRUNC);
  fs.writeSync(f.fd, zipBytes.buffer as ArrayBuffer);
  fs.closeSync(f);

  // 2. 解压
  await zlib.decompressFile(zipDest, filesDir,
        { level: zlib.CompressLevel.COMPRESS_LEVEL_DEFAULT_COMPRESSION });

  // 3. 清理临时 zip
  try { fs.unlinkSync(zipDest); } catch {}
  return bundleDest;
}

import { TELicenseCheck } from 'libxmagic';

const LICENSE_URL = 'https://xxxx.trtcube-license.vod-test.com/license/.../v_cube.license';
const LICENSE_KEY = '<从腾讯云控制台获取的 KEY>';

TELicenseCheck.setTELicense(LICENSE_URL, LICENSE_KEY).then((res) => {
  if (res.code === 0) {
    console.info('license ok');
    // → 此后才能调用 XMagicKit.initialize / processTexture
  } else {
    console.error(`license failed: code=${res.code} msg=${res.message}`);
  }
});

const code = TELicenseCheck.verifyLicense(licenseString, LICENSE_KEY);
// code === 0 表示成功

import { XMagicKit, XmagicConstant } from 'libxmagic';

const ok: boolean = XMagicKit.initialize(
  width,            // 输入纹理宽度（像素）
  height,           // 输入纹理高度（像素）
  resDir,           // LightCore.bundle 的父目录，例如 filesDir + '/res'
  XmagicConstant.EFFECT_MODE_PRO   // 可选：EFFECT_MODE_NORMAL / EFFECT_MODE_PRO
);

const outTexId: number = XMagicKit.processTexture(
  inputTexId,   // 输入纹理 ID（OES 已解码到 RGBA）
  width,        // 输入纹理宽度
  height        // 输入纹理高度
);
// outTexId 为输出纹理 ID（GL_TEXTURE_2D, RGBA8）
// 未初始化或鉴权失败时，会原样返回 inputTexId

const flipY = outTexId !== 0 && outTexId !== inputTexId;
entry.nativeRenderTexture(XCOMPONENT_ID, outTexId, flipY);

XMagicKit.release();

XMagicKit.setEffect(
  effectName,    // 特效 key（详见 XmagicConstant）
  effectValue,   // 强度，整数 0~100
  resourcePath,  // 资源路径或空串
  extraInfo      // 可选额外参数 Record<string, string>
);

import { XMagicKit, XmagicConstant } from 'libxmagic';

// 磨皮 80%
XMagicKit.setEffect(XmagicConstant.BEAUTY_SMOOTH, 80, '');
// 美白 60%
XMagicKit.setEffect(XmagicConstant.BEAUTY_WHITEN, 60, '');
// 大眼 50%
XMagicKit.setEffect(XmagicConstant.BEAUTY_ENLARGE_EYE, 50, '');

// 滤镜资源路径取自 lut.json
XMagicKit.setEffect(
  XmagicConstant.EFFECT_LUT,
  100,
  resDir + '/lut/filter_xxx.png'
);

// motionResPath 为 MotionRes 解压根目录
const stickerDir = motionResPath + '/2dMotionRes/video_xxx';
XMagicKit.setEffect(XmagicConstant.EFFECT_MOTION, 100, stickerDir);

XMagicKit.setEffect(XmagicConstant.EFFECT_MOTION, 0, '');
// 或 setEffect(XmagicConstant.XMAGIC_PROPERTY_ID_NONE, 0, '');

XMagicKit.setFeatureEnableDisable(XmagicConstant.SEGMENTATION_SKIN, true);
XMagicKit.setFeatureEnableDisable(XmagicConstant.SMART_BEAUTY, true);

import { displaySync } from '@kit.ArkGraphics2D';
import { XMagicKit, TELicenseCheck, XmagicConstant } from 'libxmagic';

@Entry @Component
struct CameraPage {
  private isLicenseOk = false;
  private isXmagicOk  = false;
  private xmagicResDir = '';
  private cameraW = 0;
  private cameraH = 0;

  aboutToAppear() {
    // 1. 鉴权（异步）
    TELicenseCheck.setTELicense(LICENSE_URL, LICENSE_KEY).then(r => {
      this.isLicenseOk = (r.code === 0);
    });

    // 2. 准备 LightCore.bundle 资源（异步）
    this.ensureLightCoreBundle().then(dir => { this.xmagicResDir = dir; });
  }

  aboutToDisappear() {
    XMagicKit.release();
  }

  // 在每帧 GL 回调中：
  private onFrame(inputTexId: number) {
    // 3. 首帧到来后惰性初始化（必须在 GL 线程）
    if (!this.isXmagicOk && this.isLicenseOk && this.xmagicResDir) {
      this.isXmagicOk = XMagicKit.initialize(
        this.cameraH, this.cameraW, this.xmagicResDir
      );
    }

    // 4. 处理纹理（未初始化时透传 inputTexId）
    const outTexId = XMagicKit.processTexture(
      inputTexId, this.cameraH, this.cameraW
    );

    // 5. 上屏（注意 flipY）
    const flipY = this.isXmagicOk && outTexId !== inputTexId;
    renderToSurface(outTexId, flipY);
  }

  // UI 事件触发：
  private onSmoothChanged(value: number) {
    XMagicKit.setEffect(XmagicConstant.BEAUTY_SMOOTH, value, '');
  }
}