Open Sound Control Web Bridge 技术文档

本文档旨在帮助用户安装、使用以及详细了解 Open Sound Control Web Bridge 项目。以下是项目的主要内容：

1. 安装指南

在开始之前，确保已经安装了 Node.js。可以从 Node.js 官网 下载并安装 LTS 版本。

安装步骤如下：

$ git clone git://github.com/automata/osc-web.git
$ cd osc-web/
$ npm install

2. 项目的使用说明

运行桥接应用：

$ cd osc-web
$ node bridge.js

在 web-side/app.html 文件中有一个示例。将此静态资产托管在您喜欢的服务器上：

$ cd web-side/
$ python -m SimpleHTTPServer 5000

在浏览器中打开 http://localhost:5000/app.html。

现在，您可以运行您喜欢的 OSC 应用程序或设备，并通过端口 3333 发送 OSC 消息。这些消息将通过 WebSocket 发送到 HTML 页面。

配置您的 OSC 应用程序或设备，使其监听端口 3334 上传入的 OSC 消息。任何由 app.html 发送的消息（例如点击按钮）都会被发送到您的 OSC 应用程序或设备。

因此，可以将 HTML 页面视为一个 "OSC 节点"，在 3333 端口上监听消息，并向 3334 端口发送消息。

查看 osc-side/ 目录，了解 OSC 应用的示例。

3. 项目 API 使用文档

本项目主要使用 WebSocket 进行通信。以下是基本的使用方法：

• 监听端口 3333 的 OSC 消息，将其转换为 WebSocket 消息发送到前端。
• 监听前端通过 WebSocket 发送的 OSC 消息，将其转换为 OSC 消息发送到OSC应用程序或设备。

4. 项目安装方式

项目的安装方式已在 "安装指南" 部分详细说明，以下是简要步骤：

$ git clone git://github.com/automata/osc-web.git
$ cd osc-web/
$ npm install

确保已经安装了 Node.js 和必要的依赖项。按照上述步骤进行操作即可成功安装项目。