リファレンス

この章は、コードから書き出した一覧です。手で書いた説明（1〜8章）と食い違ったときは、こちらが正です（コードと食い違ったときは、コードが正）。

• 書き出した元：Ulexite TV 0.3.0 / Ulexite OS（ワールド）1 / App Services 4（1.1.0）・2026-10-23
• 元のコード：Packages/vrc.ulexite.tv/Editor/UlexiteAppManifest.cs（マニフェスト）、Runtime/UlexiteAppServices.cs（窓口）、Editor/UlexiteDataAppBuilder.cs と Runtime/UlexiteDataApp.cs（データで書くアプリ）、Runtime/UlexiteAlerts.cs と Editor/UlexiteTestTvBuilder.cs（アイコンと色）、Editor/UlexiteAppBuilder.cs（UlexiteBuildKit）
• 仮の値は [...] で囲みます。t: で始まる文字列は翻訳表のキーです

9.1 マニフェスト（ulexite-app.json）

アプリのパッケージの直下（package.json の隣）に置きます。version と作者は package.json が正です（VCC が読むのは package.json だけ）。テレビを作り直すときに読み、決まりに合わないところは Console にエラーで出ます（UlexiteAppManifest.Check）。

{
  "manifestVersion": 1,
  "id": "weather",
  "name": { "ja": "天気", "en": "Weather" },
  "version": "0.2.0",
  "publisher": { "name": "Ulexite Technologies", "url": "https://example.com" },
  "kind": "declarative",
  "runtimes": { "world": { "os": 1, "appServices": 4, "screens": "app.screens.json" } },
  "profiles": ["tv"],
  "permissions": [],
  "data": [],
  "settings": [],
  "budget": { "saveKB": 4, "imagesPerOpen": 1, "syncBytes": 256 },
  "releaseNotes": { "ja": "最初のバージョン", "en": "First version" },
  "icon": "Textures/icon.png",
  "category": "info"
}

トップレベル

runtimes.world

data（読むファイル）

マニフェストの data は、URL を直接指定するデータ（時差の表など）に使います。データで書くアプリの画面のデータは、定義のファイル（9.3）の assets・data に書きます。

settings（アプリの設定項目）

アプリの画面から開く共通のパネルに出ます。最大 8 件。

翻訳キーの書き方：マニフェストに書く label・note はキーそのもの（t: を付けない）です。データで書くアプリの定義（9.3）では t: を付けます。

budget（予算）

releaseNotes

{ "ja": "...", "en": "..." }。アプリ情報に出ます。

足すだけの欄（今は読みません）

9.2 App Services（services）

アプリは launcher ではなく services（App Services） を通して Ulexite TV の仕組みを使います。UlexiteApp の services フィールドに、ランチャーが Start で入れます（アプリ側で探す必要はありません）。

• 戻り値のある窓口は、その場で値が返ります
• 結果を待つもの（データ・画像・確認・文字入力）は、アプリのイベントに届きます（9.2.14）
• アプリへの知らせは 1フレーム遅れて届きます（アプリで例外が出ても窓口とランチャーが止まらないように）

9.2.1 版と自分

9.2.2 翻訳と操作音

9.2.3 ループ再生

9.2.4 テーマ

9.2.5 通知とトースト

9.2.6 メディア（再生）

注意：VRCUrl は焼き込んだものだけ渡せます（Udon は文字列から URL を作れません）。URL はマニフェストか定義の assets に書いてください。

9.2.7 画像

9.2.8 データ（feed）

アプリ ID の feed（マニフェスト／定義の data で id を書いたもの）

URL を直接指定するデータ（マニフェストの data.url。時差の表など。名前は「アプリID-データの id」。App Services 3 以降＝Ulexite TV 0.4.0 から）

9.2.9 保存（PlayerData）

注意：他人の PlayerData は読めますが、書けるのは本人だけです。1つのキーが変わると全員の PlayerData が送られるので、キーは少数にまとめ、よく変わるものは共有データへ。

9.2.10 共有データ（全員に同期・インスタンスの間だけ）

注意：文字は 128 字まで（長いものは切られます）。< は全角になります（外部の文字でリッチテキストを使わせないため）。保存はされません（インスタンスの間だけ）。

9.2.11 確認ダイアログ

9.2.12 文字入力

注意：URL はここでは受け付けません（Udon は文字から URL を作れないため）。URL は VRCUrlInputField を自分で置いてください。

9.2.13 地域・設定・そのほか

9.2.14 アプリに届くイベント

必要なものだけ書けばよいです（書かなければ何も起きません）。

9.2.15 呼ぶ順と気をつけること

1. _Init で feed を登録（_RegisterFeed／_RegisterDataFeed）。開いたときに読み直すのは _OnOpen で _ReloadFeed
2. 保存は StorageReady が true になってから。_Save* が false を返すときは、まだ読めていないか、ID の形が違います
3. 確認と文字入力は「操作する人」だけ。false が返ったら開けていません（操作していない人から呼ばれた）
4. 答えはイベントで受ける。_Confirm の戻り値は「開けたか」だけで、はい／いいえは DialogAccepted
5. 通知の id はアプリの中で一意に。同じ id で書き換えます。消すときは _RemoveNotify
6. _OpenApp の動作と引数は同期しません（開くことだけ全員にそろう）。開いたアプリが結果を自分で同期してください
7. Udon の制約：List は使えません（配列か DataList）。例外が出た UdonBehaviour はそのセッション止まるので、重い処理は分けます（3章）

9.3 データで書くアプリ（定義のファイル）

runtimes.world.screens に書いたファイル（app.screens.json）の中身です。書き方は 4章。

9.3.1 トップレベル

9.3.2 画面の型

9.3.3 部品

cards[].parts[] に書きます。

9.3.4 値のはめ込みと整形

{{ 道筋 }} で値をはめ、| でつないで整形します。

scale:temp は 0 未満が #7fb0e8、10 未満が #a8c7fa、20 未満が #e3e3e6、30 未満が #f2d16b、それ以上が #ff8a65 です。

9.4 テーマの色

アプリは色を直接書かず、名前で引きます（native は services._Theme("surface")、データで書くアプリは maps の色の名前）。値はテレビの既定のテーマです。

札（badge）の色

札の色は意味の名前で書きます（maps や badge.color）。文字の色と、level5 の囲み線は OS が決めます。

防災のレベルと震度、飛行区分はテーマで変わりません（気象庁の色に合わせています）。

9.5 アイコン

通知・トーストのアイコン（_Notify・_Toast の icon）

UlexiteAlerts の定数です。

部品のアイコン（icon 部品・value の icon・K.Icon の名前）

add・alarm・alert・back・city・clock・cloud・dot・epicenter・gear・home・info・info-circle・link・media・moon-0〜moon-7・next・pause・play・power・previous・rain・recall・remote・retry・services・sleep・snow・spinner・stop・store・sun・tv・warn

9.6 画面のコード例

実際に動いているアプリから読むのがいちばん確かです。

時計アプリで分かること：_Init での feed 登録、_SettingString／_SettingOrderKey での設定の読み方、_SaveString での保存、_PlayLoopLocal でのアラーム、GetTileWidget でのライブタイル、UlexiteBuildKit（K.CreateApp・K.Rect・K.Tmp・K.Focus）での画面の組み立て。

9.7 版

• この章はコードから書き出したものです。版が変わったら、この章も更新します。
• 説明の章（1〜8）と食い違ったときは、この章（＝コード）が正です。

目次に戻る