si-m1-face-package/README.zh-CN.md

2.7 KiB
Raw Blame History

AISU SI-M1 Face SDK

xin.aisu.si-m1.face 是面向 AISU SI-M1 人脸识别模组的 Unity UPM 包。公开发布包以编译后的 DLL 形式提供,不包含 SDK 源码、Demo 源码、测试源码或调试符号。

English documentation: README.md.

包信息

项目
Package Name xin.aisu.si-m1.face
Display Name AISU SI-M1 Face SDK
Version 0.1.2
Runtime Assembly Aisu.SIM1.Face.Runtime.dll
Editor Assembly Aisu.SIM1.Face.Editor.dll
Unity Version 2021.3 或更高
用户项目配置资产 导入项目中的 Assets/AISU/SI-M1 Face SDK/FaceSdkSettings.asset

安装

在 Unity Package Manager 中使用以下 Git URL 导入:

https://git.aisu.xin/aisu-sdk/si-m1-face-package.git#v0.1.2

或写入 Packages/manifest.json

"xin.aisu.si-m1.face": "https://git.aisu.xin/aisu-sdk/si-m1-face-package.git#v0.1.2"

Unity 对 Git URL 包可能会在 Library/PackageCache 中显示为 xin.aisu.si-m1.face@<commit-hash>。这是 Git 包的正常行为;包版本仍由 package.json 中的 version 字段定义。

快速开始

  1. 打开 AISU/SI-M1 Face SDK/Settings,创建或加载 FaceSdkSettings
  2. 配置串口号、波特率、Mock 模式和日志选项。
  3. 打开 AISU/SI-M1 Face SDK/Create Manager GameObject,在当前场景中创建 FaceModuleManager
  4. 在业务脚本中引用该 Manager 并调用 SDK 服务。
using Aisu.SIM1.Face.Core;
using UnityEngine;

public sealed class FaceExample : MonoBehaviour
{
    [SerializeField] private FaceModuleManager manager;

    private async void Start()
    {
        manager.Open();
        await manager.WaitReadyAsync();

        var version = await manager.Basic.GetVersionAsync();
        Debug.Log("SI-M1 version: " + version);
    }
}

文档

English 中文
Quick Start 快速开始
Configuration 配置说明
API Reference API 参考
Mock and Testing Mock 与测试
Demo UI Notice Demo UI 说明

公开包范围

  • 不包含 SDK 源码。
  • 不包含 .pdb 调试符号。
  • 不包含 Demo 和测试源码。
  • DLL-only 公开版本不包含可导入的 Samples~
  • 示例源码和内部验证测试保留在私有开发 SDK 仓库中。