Nextcloud向けVRMビューワー

概要

Nextcloud向けのVRMビューワーは、Nextcloud上でVRM形式の3DモデルとVRMA形式のアニメーションをプレビューできるようにするAppです。
このAppを導入することで、Nextcloudのファイル管理機能と組み合わせて、ユーザーが簡単に3Dモデルやアニメーションを簡単にプレビューできます。

使用技術

• フロントエンド：TypeScript、Vue 2.7、Three.js、WebGL、@pixiv/three-vrm
• Nextcloud連携：Files API、Viewer API、Nextcloud Vue
• バックエンド：PHP 8.2、Nextcloud AppFramework、Preview Provider API
• 開発環境：Vite、Docker Compose、Nextcloud 34

工夫点

• VRM0.0/1.0で異なる座標系や腕の回転方向を吸収し、モデルの大きさと表示領域からカメラ位置を自動計算することで、さまざまな体格のモデルを全身表示できるようにしています。
• VRMの取得先を同一オリジンに制限し、外部画像や外部バッファを参照するGLBを拒否します。サーバー側のサムネイル抽出では、チャンク境界、オフセット、画像形式、データサイズを検証し、破損ファイルや過大なデータを安全に処理しています。