Files

e2hang 798e5c2f7d checkpoint: segfault root cause analysis + Live2D stability fixes

- _refresh_messages: widget pool reuse to avoid layout cascade → QWebEngineView crash
- viewer.html: QWebChannel bridge, texture resize, burst render, gl.finish
- live2d_view.py: debug checkpoints, playMotion/setExpression render-on-demand
- main.py: Chromium flags --no-sandbox --in-process-gpu --disable-gpu-rasterization --ignore-gpu-blocklist
- scheduler.py: test_reminder re-enabled
- docs: complete root cause analysis

2026-05-23 13:33:58 +08:00

6.1 KiB

Raw Permalink Blame History

English / 日本語

Cubism Web Framework

Live2D Cubism Editor で出力したモデルをアプリケーションで利用するためのフレームワークです。

モデルを表示、操作するための各種機能を提供します。モデルをロードするには Live2D Cubism Core ライブラリと組み合わせて使用します。

ビルドを行うことで、ブラウザで利用可能な JavaScript ライブラリとして利用することができます。

ライセンス

本 SDK を使用する前に、ライセンスをご確認ください。

Cubism 5.3新機能や過去バージョンとの互換性について

本 SDK はCubism 5.3に対応した製品です。 Cubism 5.3 Editorに搭載された新機能のSDK対応についてはこちらをご確認ください。過去バージョンのCubism SDKとの互換性についてはこちらをご確認ください。

開発環境

Node.js

25.8.2
24.14.1

TypeScript

5.9.3

開発環境構築

[Node.js] と [Visual Studio Code] をインストールします
Visual Studio Code で本プロジェクトを開き、推奨拡張機能をインストールします
- 拡張機能タブから @recommended と入力することで確認できます
コマンドパレット（View > Command Palette...）で >Tasks: Run Task を入力してタスク一覧を表示します
npm: install を選択して依存パッケージのダウンロードを行います

コマンドパレットのタスク一覧から各種コマンドを実行することができます。

NOTE: デバッグ用の設定は、.vscode/tasks.json に記述しています。

タスク一覧

`npm: build`

ソースファイルのビルドを行い、dist ディレクトリに出力します。

tsconfig.json を編集することで設定内容を変更できます。

`npm: test`

TypeScript の型チェックテストを行います。

tsconfig.json を編集することで設定内容を変更できます。

`npm: lint`

src ディレクトリ内の TypeScript ファイルの静的解析を行います。

eslint.config.mjs を編集することで設定内容を変更できます。

`npm: lint:fix`

src ディレクトリ内の TypeScript ファイルの静的解析及び自動修正を行います。

eslint.config.mjs を編集することで設定内容を変更できます。

`npm: clean`

ビルド成果物ディレクトリ（dist）を削除します。

コンポーネント

effect

自動まばたきやリップシンクなど、モデルに対してモーション情報をエフェクト的に付加する機能を提供します。

id

モデルに設定されたパラメータ名・パーツ名・Drawable名を独自の型で管理する機能を提供します。

math

行列計算やベクトル計算など、モデルの操作や描画に必要な算術演算の機能を提供します。

model

モデルを取り扱うための各種機能（生成、更新、破棄）を提供します。

motion

モデルにモーションデータを適用するための各種機能（モーション再生、パラメータブレンド）を提供します。

physics

モデルに物理演算による変形操作を適用するための機能を提供します。

rendering

モデルを描画するためのグラフィックス命令を実装したレンダラを提供します。

type

フレームワーク内で使用する型定義を提供します。

utils

JSONパーサーやログ出力などのユーティリティ機能を提供します。

Live2D Cubism Core for Web

当リポジトリには Cubism Core for Web は同梱されていません。

Cubism SDK for Web からダウンロードしてください。

サンプル

標準的なアプリケーションの実装例は CubismWebSamples を参照ください。

マニュアル

Cubism SDK Manual

変更履歴

当リポジトリの変更履歴については CHANGELOG.md を参照ください。

プロジェクトへの貢献

プロジェクトに貢献する方法はたくさんあります。バグのログの記録、このGitHubでのプルリクエストの送信、Live2Dコミュニティでの問題の報告と提案の作成です。

フォークとプルリクエスト

修正、改善、さらには新機能をもたらすかどうかにかかわらず、プルリクエストに感謝します。メインリポジトリを可能な限りクリーンに保つために、必要に応じて個人用フォークと機能ブランチを作成してください。

バグ

Live2Dコミュニティでは、問題のレポートと機能リクエストを定期的にチェックしています。バグレポートを提出する前に、Live2Dコミュニティで検索して、問題のレポートまたは機能リクエストがすでに投稿されているかどうかを確認してください。問題がすでに存在する場合は、関連するコメントを追記してください。

提案

SDKの将来についてのフィードバックにも関心があります。Live2Dコミュニティで提案や機能のリクエストを送信できます。このプロセスをより効果的にするために、それらをより明確に定義するのに役立つより多くの情報を含めるようお願いしています。

フォーラム

ユーザー同士でCubism SDKの活用方法の提案や質問をしたい場合は、是非フォーラムをご活用ください。

6.1 KiB Raw Permalink Blame History