🚀 VRC OSC App

✨ 在手机上利用OSC协议，在VRChat游戏内与模型进行各种交互

---

🌟 当前实现的功能

• ✅ 手机上操控模型的轮盘上的各种预设(目前仅支持boolean类型操作和百分比操作项,其它类型会置灰不可操作)
• ✅ 手机上语音翻译并显示在chatbox上
• ✅ 持久化存储avatar数据
• ✅ 支持avatar的json字符串导入
• ✅ 本地IP和端口的修改
• ......more are coming soon

📸 应用截图

📦 安装与使用

# 克隆项目
git clone https://github.com/laststranger/vrc_osc_app.git
cd vrc_osc_app

# 安装依赖
npm install

# 运行项目
npx expo prebuild --clean
npm run start

# iOS 运行与安装命令
npx expo run:ios                                    # 运行到电脑模拟器 (Debug 模式)
npx expo run:ios --device                           # 安装到 iOS 真机 (Debug 模式，需连接电脑 Metro 服务)
npx expo run:ios --device --configuration Release   # 安装到 iOS 真机 (Release 独立运行包，脱离电脑运行)

# Android 运行
npx expo run:android                                # 运行到 Android 模拟器/真机

⚠️ 注意事项

• 模型数据: 模型的json文件目录在 C:\Users\XXX\AppData\LocalLow\VRChat\VRChat\OSC\usr_XXXXXXXX\Avatars 目录下，将项目中的data.json文件内容替换操控的模型数据

• 翻译功能: 需要使用腾讯云的 API Key，创建一个 .env 文件，填入以下内容：

  EXPO_PUBLIC_TENCENT_SECRET_ID="XXXXX"
  EXPO_PUBLIC_TENCENT_SECRET_KEY="XXXX"

• 打包与真机安装说明:

  • iOS: 需要使用 Mac 电脑连接 iPhone 本地打包安装。如果要生成不需要连接电脑 Metro 服务的离线独立 App，请使用：

    npx expo run:ios --device --configuration Release

  • Android: 安卓包可以直接从 Release 区下载 apk 安装即可。

🤝 贡献指南

欢迎任何形式的贡献！你可以：

• 📝 提交 Issue 反馈问题
• 🔧 Fork 项目并提交 Pull Request
• 💡 提出新的功能建议

📜 许可证

本项目遵循 MIT 许可证。

---

🚀 喜欢这个项目的话，欢迎 Star ⭐，让更多人看到它！