🚀 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 模拟器/真机 (Debug 模式)
npx expo run:android --variant release             # 本地打包并安装 Android Release 独立包

⚠️ 注意事项

• 模型数据: 模型的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:

      # 方式 1：使用 Expo CLI 一键编译并安装到设备
      npx expo run:android --variant release
      
      # 方式 2：使用 Gradle 直接生成 Release APK
      cd android && ./gradlew assembleRelease

      生成文件路径：android/app/build/outputs/apk/release/app-release.apk
    • 生成 Google Play 上架 App Bundle (.aab):

      cd android && ./gradlew bundleRelease

      生成文件路径：android/app/build/outputs/bundle/release/app-release.aab
    • 也可直接从项目的 Release 发布区下载已构建好的安装包。

🤝 贡献指南

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

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

📜 许可证

本项目遵循 MIT 许可证。

---

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