Skip to content

pxwg/island-vrm-test

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

灵动岛上的 VRM 模型

在灵动岛上展示 VRM 模型的技术验证项目。

Warning

本项目是一个技术验证项目,大量使用 vibe coding 技术。UI 代码大量参考 Boring Notch

Important

本项目作为技术验证项目,最终愿景为利用 VRM 与 AI 技术,探索面向高龄群体的 “智能陪伴” 与面向年轻群体的 “高效虚拟助理” 解决方案。

使用界限:

  • 本项目并非为满足 “虚拟恋人”“恋爱模拟”“情感替代” 等需求而设计。
  • 项目中提供的所有被展示的模型资源仅作为技术验证与测试用例,不代表作者的个人倾向。

倡导: 作者主张理性使用虚拟形象技术,将其作为辅助生活与提升效率的工具。我们 不鼓励 用户对虚拟角色产生过度情感投射或非理性的现实解离,并始终支持用户与现实世界建立良性的交互关系。

2026-01-17.21.57.34.mov

功能

  • 在灵动岛上展示 VRM 模型
  • 鼠标位于灵动岛区域时,展开灵动岛,显示更多动作
  • 头部与眼睛跟随鼠标移动
  • 循环播放 VRMA 动作,即使原本动作不是循环的
  • 原生配置系统 (Native First):
    • 在托盘找到应用图标,cmd+, 打开配置界面,配置模型的摄像机角度
      • 注意,由于折叠状态人物模型很小,存在一个默认的摄像机跟随人物头部的功能,因此折叠状态的摄像机角度配置不会非常明显
    • 详见:Native Configuration 文档
  • 简单的 API 调用,用于配置人物的表情、话语等后端 (WIP)

API 说明

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "AgentPerformance",
  "type": "object",
  "properties": {
    "face": {
      "type": "string",
      "description": "Agent's facial expression",
      "enum": [
        "neutral",
        "joy",
        "angry",
        "sorrow",
        "fun",
        "surprise"
      ]
    },
    "intensity": {
      "type": "number",
      "description": "Intensity of the expression (optional)",
      "minimum": 0
    },
    "action": {
      "type": "string",
      "description": "Agent's action, e.g., 'nod', 'shake', 'wave' (optional)"
    },
    "audio_url": {
      "type": "string",
      "description": "URL to the audio file (optional)",
      "format": "uri"
    },
    "duration": {
      "type": "number",
      "description": "Duration of the performance in seconds (optional)",
      "minimum": 0
    }
  },
  "required": [
    "face"
  ],
  "additionalProperties": false
}

快速开始

  • git clone 本仓库
  • 下载 VRM 模型与动作资源,放置在 web/public/ 目录下,命名为avatar.vrmidle.vrma
  • 运行 bash ./build.sh 构建项目
  • 运行 open ./build/IslandVRM.app 运行项目
    • 在托盘中找到应用图标,打开配置界面或退出应用
  • 可以在 xcode 中预览部分 UI

About

Vrm model in MacOS dynamic island for technical verification.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors