Skip to content

README_CN.md

Latest commit

 

History

History
224 lines (171 loc) · 7.46 KB

README_CN.md

File metadata and controls

224 lines (171 loc) · 7.46 KB

uDesktopMascot

Unity 版本 版本发布 Unity 测试 CI Ask DeepWiki

日本語 | English | 中文 | Español | Français

注意: 上述语言（English、中文、Español、Français）由 GPT-4o-mini 自动翻译生成。翻译的准确性和语义方面请参照原文（日本語）。

概述

“uDesktopMascot”是一个以创作的自由化为主题的桌面吉祥物应用程序的开源项目。 作为一个功能示例，它可以加载VRM和GLB/FBX格式的模型，并在桌面上显示。此外，还可以自由设置菜单界面和应用程序窗口等GUI的颜色和背景图像。 详细功能列表请参见 功能列表。

支持平台

  • Windows 10/11
  • macOS

功能列表

应用程序实现了以下功能。详细信息请参阅下面的列表。

通过将外部资产放入StreamingAssets文件夹可以实现其添加。

模型・动画
  • 加载并显示放置在StreamingAssets中的任意模型文件。
    • 支持VRM (1.x, 0.x)格式模型。
    • 支持GLB/GLTF格式模型。(不支持动画)
    • 支持FBX格式模型。(但部分模型的纹理无法加载。并且不支持动画)
      • 纹理可通过放置在StreamingAssets/textures/中加载。
  • 从模型选择和添加界面添加VRM模型
    • 指定路径以添加
    • 从文件选择对话框添加
语音・背景音乐
  • 加载并播放放置在SteamingAssets/Voice/中的音频文件。如果有多个，将随机播放。
    • 点击时播放的音频是从StreamingAssets/Voice/Click/中加载的音频文件。
  • 加载并播放放置在SteamingAssets/BGM/中的音乐文件。如果有多个，将随机播放。
  • 角色的默认语音添加
语音识别・AI聊天
  • 集成离线语音识别引擎 Vosk，将麦克风输入实时转换为文本。
    • 在Unity控制台中显示中间结果[STT][partial]和确定结果[STT][final]。
    • 如果静音持续VadSilenceSeconds（默认1.0秒），文本将被确认并发送到LLM（[STT][send]日志）。
  • 文本确认后，将音频消息传递给AI聊天功能，角色将朗读响应。
    • 在生成响应期间，麦克风将自动暂停以防止误识别。
  • 在ChatDialog界面的麦克风按钮上，可以切换录音的开始/停止。
  • 所需的原生DLL（libvosk.dll, libstdc++-6.dll, libgcc_s_seh-1.dll, libwinpthread-1.dll等）将放置在Assets/Plugins/x86_64/中，并将自动打包到构建中。
  • 通过将音频模型（例如：vosk-model-small-ja-0.22）和量化的GGUF模型放置在StreamingAssets下，可以在没有网络连接的情况下处理多种语言（如日语/英语）。
通过文本文件进行应用程序设置 可以通过application_settings.txt文件更改应用程序的设置。

设置文件的结构如下：

[Character]
ModelPath=default.vrm
TexturePaths=test.png
Scale=3
PositionX=0
PositionY=0
PositionZ=0
RotationX=0
RotationY=0
RotationZ=0

[Sound]
VoiceVolume=1
BGMVolume=0.5
SEVolume=1

[Display]
Opacity=1
AlwaysOnTop=True

[Performance]
TargetFrameRate=60
QualityLevel=2
菜单界面
  • 可设置菜单界面的背景图像和背景颜色。
    • 背景图像可加载放置在StreamingAssets/Menu/中的图像文件。支持的图像格式如下：
      • PNG
      • JPG(JPEG)
      • BMP
      • GIF(静态图)
      • TGA
      • TIFF
    • 背景颜色可以指定颜色代码。
  • 从菜单界面可以访问以下功能：
    • 模型选择和添加界面
    • AI聊天功能
    • LocalWeb功能
    • 应用程序设置
    • 应用程序退出
  • 通过点击菜单界面的收纳按钮，可以在Windows的通知区域隐藏应用程序。
    • 隐藏的应用程序可以通过点击通知区域的图标再次显示。

在macOS上的执行

在macOS上执行应用程序时，可能会被GateKeeper阻止。 在这种情况下，请在终端中运行以下命令。

xattr -r -c uDesktopMascot.app

要求

  • Unity 6000.1.1f1(IL2CPP)

许可证

素材信息

安装程序创建方法

Windows

  • 在Unity中将uDesktopMascot命名为build文件夹并进行构建。
uDesktopMascot
└── build
    └── uDesktopMascot
        ├── uDesktopMascot.exe
        └── README.txt
        ...

  • 安装Inno Setup工具。

  • 打开后，点击More files，选择项目下的setup.iss。

  • 选择后，点击播放按钮。

  • 构建完成后，安装程序将生成在项目的根目录下。

macOS

仅可在macOS PC上创建安装程序。

  • 在Unity中将uDesktopMascot命名为build/uDesktopMascot文件夹并进行构建。
uDesktopMascot
└── build
    └── uDesktopMascot
        ├── uDesktopMascot.app
        └── README.txt
  • 执行以下命令。
cd build
productbuild --component uDesktopMascot/uDesktopMascot.app /Applications ./uDesktopMascot_mac_installer.pkg
  • 构建完成后，build文件夹中将生成uDesktopMascot_mac_installer.pkg。

制作人员信用

  • 模型: 「アオゾラ」様
  • BGM: MidraLab(eisuke)
  • 软件图标: やむちゃ様

第三方通知

请参见NOTICE。

赞助商

  • Luna
  • uezo