# SignLanguage

**Repository Path**: MakerStudio_OH/SignLanguage

## Basic Information

- **Project Name**: SignLanguage
- **Description**: 手语识别库基于MindSpore Lite Kit，一键集成手语识别能力，完全离线运行，保障用户隐私与数据安全，适用于医疗、司法等敏感场景。
目前支持20种常用手语词汇实时翻译（将持续进行手语种类扩增）
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 1
- **Created**: 2025-05-12
- **Last Updated**: 2025-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: HarmonyOS, 鸿蒙

## README

# @maker/signlanguage

### 🚀 SignLanguage手语识别引擎

手语识别库基于MindSpore Lite Kit，一键集成手语识别能力，完全离线运行，保障用户隐私与数据安全，适用于医疗、司法等敏感场景。  
目前支持36种常用手语词汇翻译（团队将持续进行手语种类扩增）

| 手语英文名     | 手语中文名 |
|:----------|:------|
| accept    | 接受    |
| also      | 也     |
| always    | 一直    |
| and       | 和     |
| arrive    | 到达    |
| born      | 出生    |
| careful   | 谨慎    |
| continue  | 继续    |
| dad       | 爸爸    |
| difficult | 困难    |
| do        | 做     |
| envy      | 嫉妒    |
| fair      | 公平    |
| give_up   | 放弃    |
| have      | 有     |
| heart     | 心     |
| here      | 这里    |
| home      | 首页    |
| identity  | 身份    |
| know      | 知道    |
| life      | 生命    |
| look      | 看     |
| love      | 爱     |
| me        | 我     |
| mom       | 妈妈    |
| no        | 不     |
| none      | 无     |
| preach    | 教     |
| safety    | 安全    |
| same      | 同样    |
| speak     | 说     |
| think     | 思考    |
| why       | 为什么   |
| wrong     | 错误    |
| you       | 你     |

### 🔨使用

#### 📦快速接入

```c
# ohpm
ohpm install @maker/signlanguage
```

#### 注意事项

|  能力  | 手部遮挡范围  | 佩戴手套 |
|:----:|:-------:|:----:|
| 手语识别 | 不超过20%✅ | 不支持  |

#### API说明

##### 👉getGesture：获取手语识别标签和准确率

getGesture(): `Promise <Gesture>`  
`import { getGesture } from '@maker/signlanguage';`

**返回值**

| 类型               | 说明                 |
|:-----------------|:-------------------|
| Promise<Gesture> | Promise对象，返回手语识别结果 |

**调用示例**

```c
Button('手语识别')
    .onClick(async ()=>{
        let out = await getGesture()
        let label = this.out.label
        let accuracy = this.out.accuracy
    })
```

##### ⚡Gesture：手语识别定义类

`import { Gesture } from '@maker/signlanguage';`

| 名称       | 类型     | 说明                               |
|:---------|:-------|:---------------------------------|
| uri      | string | 所选图片uri                          |
| label    | string | 手语识别标签                           |
| accuracy | number | 手语识别准确率                          |
| message  | string | 手部检测输出信息，“手语捕捉成功”/“未检测到手部，请重新尝试” |

### 🚀示例

调用 `getGesture()` 实现手语识别

```c
import { getGesture,Gesture } from '@maker/signlanguage';

@Entry
@Component
struct Index {
  @State image: string = ''
  @State label:string=''
  @State accuracy:number=0
  @State out:Gesture=new Gesture('','',0)

  build() {
    Column({space:20}){
      if(this.out.label!=''){
        Image(this.out.uri)
          .width(200)
          .height(200)
      }

      Button('手语识别')
        .onClick(async ()=>{
          this.out = await getGesture()
          this.label = this.out.label
          this.accuracy = this.out.accuracy
        })

      Text('识别手势为：'+this.label)
      Text('识别准确率为：'+this.accuracy.toFixed(2)+'%')
    }
    .alignItems(HorizontalAlign.Center)
    .justifyContent(FlexAlign.Center)
    .height('100%')
    .width('100%')
  }
}
```

#### 🏆效果展示

<img src="screenshots/example_img.gif"/>