[Update] クリップボード機能の設計書を追加し、設定およびコントローラーの制御を明記

This commit is contained in:
misyaguziya
2026-01-11 08:55:30 +09:00
parent 40d2678c23
commit 4559d83766
6 changed files with 445 additions and 1 deletions

View File

@@ -4,6 +4,25 @@
VRCTアプリケーションの中核となるModelクラスを定義するモジュールです。音声認識、翻訳、VRオーバーレイ、OSC通信、WebSocketサーバーなどの主要機能を統合管理し、システム全体の動作を制御します。
## 最近の更新 (2026-01-11)
### クリップボード機能
- `clipboard` インスタンスを Model 内に保持
- `setCopyToClipboard(text: str) -> bool`: 翻訳結果をクリップボードにコピー
- `setPasteFromClipboard() -> bool`: Ctrl+V でペースト実行VRChat ウィンドウ自動フォーカス)
- OpenVR による VRChat アプリ名の自動検出
### テレメトリ機能
- `telemetryInit(enabled: bool, app_version: str)`: Aptabase を用いたテレメトリ初期化
- `telemetryShutdown()`: テレメトリのシャットダウンapp_closed イベント送信)
- `telemetryTouchActivity()`: ユーザーアクティビティの記録
- `telemetry.*()`: イベント送信メソッド群
- デフォルト有効、ユーザー制御可能な設計
### その他の更新
## 最近の更新 (2025-10-20)
### VRAMエラー検出とフォールバック
@@ -315,6 +334,30 @@ message = {"type": "translation", "text": "Hello", "translation": "こんにち
success = model.websocketSendMessage(message)
```
### クリップボード機能の使用
```python
# テキストをクリップボードにコピー
text = "翻訳結果"
success = model.setCopyToClipboard(text)
# ペースト実行VRChat ウィンドウに自動フォーカス)
success = model.setPasteFromClipboard()
```
### テレメトリの初期化・シャットダウン
```python
# テレメトリ初期化(アプリ起動時)
model.telemetryInit(enabled=config.ENABLE_TELEMETRY, app_version=config.VERSION)
# テレメトリシャットダウン(アプリ終了時)
model.telemetryShutdown()
# アクティビティ記録
model.telemetryTouchActivity()
```
## 依存関係
### 必須モジュール