# ArcSoftActivate

**Repository Path**: hanzhi-code/arc-soft-activate

## Basic Information

- **Project Name**: ArcSoftActivate
- **Description**: 虹软人脸识别在线激活
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 虹软在线激活程序
## 适用范围
- 本项目适用于虹软人脸识别JAVA SDK（32位）激活，版本：ArcSoft_ArcFace_Java_Windows_x86_V3.0。
- **如需激活64位，应确保使用64位java**。
## 前置条件
- 安装`vcredist2013`（**注意区分32位和64位，这里使用32位**），微软官网下载：[VC++ 2013 Redistributable](https://www.microsoft.com/en-us/download/details.aspx?id=40784)

## 开发环境
- 使用java 1.8.0_202（**注意根据虹软sdk版本区分64位和32位**）
- 下载虹软人脸识别[JAVA SDK](https://ai.arcsoft.com.cn/ucenter/resource/build/index.html)，获取**APP_ID**和**SDK_KEY**。  
    ![img.png](img.png)
- JAVA SDK文件结构如下：  
  ![img_1.png](img_1.png)
- 将libs下的文件复制到本项目的lib/arcsoft目录下：
  ![img_2.png](img_2.png)
- 安装虹软java依赖库：  
maven>=3.9 运行：
```shell
mvn install:install-file -Dfile=lib/arcsoft/arcsoft-sdk-face-3.0.0.0.jar -DgroupId=com.arcsoft -DartifactId=arcsoft-sdk-face -Dversion=3.0.0.0 -Dpackaging=jar
```
maven<3.9 运行：
```shell
mvn org.apache.maven.plugins:maven-install-plugin:3.0.0-M1:install-file -Dfile=lib/arcsoft/arcsoft-sdk-face-3.0.0.0.jar -DgroupId=com.arcsoft -DartifactId=arcsoft-sdk-face -Dversion=3.0.0.0 -Dpackaging=jar
```
- 运行时需要添加JVM运行参数,即虹软的APP_ID和SDK_KEY `-Darcsoft.appId=xxx -Darcsoft.sdkKey=xxx -Darcsoft.libPath=.\lib\arcsoft\WIN32`
![img_4.png](img_4.png)
## 打包使用
- 运行 `mvn clean package` 生成主程序 `ArcSoftActivate-3.0.0.0-SNAPSHOT.jar`
- 新建文件夹，将主程序放到文件夹下，目录结构包含如下
```
 |-- 新建文件夹
 |-- |-- jre32      # java运行环境
 |-- |-- lib   # 虹软库文件
 |-- |-- |-- WIN32 # 其中dll文件对应虹软ArcSoft_ArcFace_Java_Windows_x86_V3.0\libs\WIN32目录下文件
 |-- |-- ArcSoftActivate-xxxxx-SNAPSHOT.jar  # 主程序
 |-- |-- 运行激活程序.bat # 启动文件
```
- 启动文件内容如下（运行激活程序.bat）
```运行激活程序.bat
@echo off
:: 根据虹软sdk版本选择对应的jre版本，注意区分32与64位
set JRE_PATH=.\jre32
:: 主程序（依赖虹软arcsoft-sdk-face-3.0.0.0.jar进行编译）
set JAR_PATH=.\ArcSoftActivate-3.0.0.0-SNAPSHOT.jar

"%JRE_PATH%\bin\java.exe" -Darcsoft.appId=xxx -Darcsoft.sdkKey=xxx -Darcsoft.libPath=.\lib\arcsoft\WIN32 -jar "%JAR_PATH%"

pause
```
1. 使用前先修改`运行激活程序.bat`
   填写`-Darcsoft.appId`、`-Darcsoft.sdkKey`，对应虹软appId和sdkKey（注意保管，不要对外泄露）
2. `-Darcsoft.libPath` 对应虹软ArcSoft_ArcFace_Java_Windows_x86_V3.0\libs\WIN32目录（虹软版本不变情况下，不需要修改）
- 运行截图
![img_3.png](img_3.png)
## 注意事项
- 生产环境下，虹软激活文件`ArcFace.dat`需要放在jar包所在目录