DepthJS 技术文档

1. 安装指南

1.1 系统要求

• 操作系统: Windows, macOS, Linux
• 浏览器: Chrome（推荐）, Safari（部分支持）, Firefox（需自行构建）
• 硬件: Microsoft Kinect

1.2 依赖安装

1. OpenNI 和 NiTE:

   • 下载并安装 OpenNI 和 NiTE 库。
   • 确保所有模块已正确注册，使用命令 niReg -l 检查。

2. SensorKinect:

   • 如果使用 Kinect，下载并安装 SensorKinect 库。

3. Firebreath:

   • 下载 Firebreath 框架。
   • 确保已安装 CMake 2.6+。

1.3 构建插件

1.3.1 macOS 构建

cd ${DEPTHJS_DIR}/firebreath-plugin/
${FIREBREATH_DIR}/prepmac.sh . build/
open build/FireBreath.xcodeproj

1.3.2 Windows 构建

cd ${DEPTHJS_DIR}/firebreath-plugin/
${FIREBREATH_DIR}/prep2010.cmd . build/
start build\FireBreath.sln

1.4 安装 Chrome 扩展

1. 进入 Chrome 扩展管理页面 chrome://extensions/。
2. 使用 "加载已解压的扩展程序..." 加载 chrome-extension 目录。
3. 使用错误控制台检查是否有错误。

2. 项目使用说明

2.1 启动手势追踪

• Wave: 开始手势追踪，出现“蓝色指针”。
• Push: 点击操作。
• Circle: 结束追踪，移除“蓝色指针”。

2.2 浏览器支持

• Chrome: 完全支持，需手动加载扩展。
• Safari: 部分支持，需手动构建和安装插件。
• Firefox: 需自行构建扩展。

3. 项目API使用文档

3.1 事件处理

• 全局事件处理: 在浏览器扩展中全局处理事件。
• 内容脚本注入: 将事件处理注入到每个网页中。
• 本地DOM事件: 通过内容脚本将事件推送到本地DOM元素。

3.2 数据流

Kinect =====> 浏览器插件/原生代码 =====> 浏览器扩展 ===(Javascript+DOM事件)==> 任意网页

4. 项目安装方式

4.1 Chrome 安装

1. 构建并加载 Chrome 扩展。
2. 使用 chrome://extensions/ 加载 chrome-extension 目录。

4.2 Safari 安装

1. 构建并运行 webkit-plugin-mac 中的 Xcode 项目。
2. 在 Safari 中启用开发者工具和扩展。
3. 使用 Extension Builder 添加 safari-extension-mac/ 中的扩展。

4.3 Firefox 安装

• 需自行构建 Firebreath NPAPI 插件并创建 Firefox 扩展。

5. 未来工作

• 改进手势识别。
• 简化安装过程，实现一键安装。
• 实现真正的跨平台跨浏览器支持。