SHIORIイベントの対応状況
ゴーストへ送るSHIORIイベントについて、Utataneが通知する条件と、SSPとの違いをまとめています。
項目名と分類の生成にはScripts/generate-shiori-event-compatibility.pyと、ローカルに保存したUKADOCを使います。各行の判定と備考は、実装や確認結果に合わせて更新します。
基準: SHIORI Eventリスト
UKADOC掲載イベント数: 304 調査日: 2026-09-24 調査結果: ✅ 248 / 🟡 45 / ❌ 2 / ➖ 9
| 記号 | 意味 |
|---|---|
| ✅ | 発生条件・Reference・応答処理を実装。実機未確認やmacOS固有差は備考に記載 |
| 🟡 | 発行経路はあるが、実装可能な発生条件・Reference・応答処理の一部が未対応 |
| ❌ | Utataneから自動発行する実装がない |
| ➖ | Windows固有などmacOSでは非該当、旧仕様に置き換え済み、または現行UKADOCで契約未定義 |
名前がソースに現れるだけでは対応としません。発生条件・Reference・GET/NOTIFY・応答利用をUKADOCに照らし、契約を満たすものは✅、一部不足は🟡、自動発行経路がないものは❌に分類します。 任意IDを中継できる経路（raise、inputbox、HTTP等）は、そのイベントをベースウェアが自動発行する実装とは数えません。 全イベントを本番Swiftコード（テストコードを除く）の固定IDおよびイベント生成経路と照合します。✅のmacOS固有差と実機確認状況は備考に残します。 ➖はWindows固有機能、旧仕様、または現行UKADOCで契約を実装できない根拠を備考へ記録します。Utatane側の機能不足だけを理由に➖へ分類しません。
起動・終了・切り替えイベント
Section titled “起動・終了・切り替えイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnFirstBoot |
✅ | 初回起動時に消滅回数0をReference0へ通知し、無応答ならOnBootへフォールバック。イベント生成とフォールバックをテスト済み |
OnBoot |
✅ | 起動シェル名をReference0へ通知。OnFirstBoot・OnGhostChanged・OnGhostCalled・OnVanishedが無応答の時にフォールバックする経路をテスト済み |
OnClose |
✅ | 終了理由をReference0、メニューと終了対象のscopeをReference1・2へ通知。通常終了とOnCloseAllからのフォールバックをテスト済み |
OnCloseAll |
✅ | アプリ終了時にuser、macOSの終了通知時にsystemをReference0へ通知。応答がない場合だけOnCloseへフォールバックし、応答があれば抑制する経路をテスト済み |
OnGhostChanged |
✅ | 切替元の本体名・終了スクリプト・ゴースト名・パスと切替先シェル名をReference0〜3・7へ通知し、無応答ならOnBootへフォールバック。テスト済み |
OnGhostChanging |
🟡 | 手動切替前に切替先の本体側名・manual・ゴースト名・パスをReference0〜3へ通知。無応答ならOnCloseへフォールバック。automatic理由を使う自動切替は未実装 |
OnGhostCalled |
✅ | 呼出先で呼出元の本体名・呼出スクリプト・ゴースト名・パスと呼出先シェル名をReference0〜3・7へ通知し、無応答ならOnBootへフォールバック。テスト済み |
OnGhostCalling |
🟡 | 手動呼出時のReference0〜3を実装。automatic経路は未実装 |
OnGhostCallComplete |
✅ | 呼出完了後に呼出先の本体名・起動スクリプト・ゴースト名・シェル名をReference0〜2・7へ通知。イベント生成をテスト済み |
OnOtherGhostBooted |
✅ | 呼び出しゴーストの起動完了時、無関係な起動中ゴーストへ本体名・起動スクリプト・ゴースト名・シェル名をReference0〜2・7で通知。イベント生成をテスト済み |
OnOtherGhostChanged |
✅ | 呼び出しゴーストの切替時に切替前後の本体名・ゴースト名・パス・シェル名を、メインと他の呼び出しゴーストへ通知 |
OnOtherGhostClosed |
✅ | 呼び出しゴーストの終了後、本体名・最終スクリプト・ゴースト名・シェル名をReference0〜2・7へ通知。イベント生成をテスト済み |
OnShellChanged |
✅ | 切替後に現シェル名・ゴースト名・シェルパスをReference0〜2へ通知。イベント生成テストで確認 |
OnShellChanging |
✅ | 切替前に新旧シェル名と新シェルパスをReference0〜2へ通知。イベント生成テストで確認 |
OnDressupChanged |
🟡 | script／userの着せ替え変更でReference0〜4を送信。複数変更は最後だけGET、それ以前はNOTIFY、100件以上はOnNotifyDressupInfoのみ。応答利用をテスト済み、実ゴーストでの操作確認待ち |
OnBalloonChange |
✅ | 切替後のバルーン名とフルパスをReference0〜1へ通知。メイン・呼び出しゴーストの共通イベント生成をテスト済み |
OnWindowStateRestore |
🟡 | macOSでアプリの非表示が解除された時にReference0=systemを通知。script・user理由の区別は未対応 |
OnWindowStateMinimize |
🟡 | macOSでアプリが非表示になった時にReference0=systemを通知。script・user理由の区別は未対応 |
OnFullScreenAppMinimize |
✅ | 前面アプリの通常レイヤに画面全体と一致するウインドウを検出すると、シェル・バルーンを透過してReference0=fullscreenを通知 |
OnFullScreenAppRestore |
✅ | 前面アプリの全画面ウインドウがなくなると、シェル・バルーンを再表示してReference0=fullscreenを通知 |
OnVirtualDesktopChanged |
✅ | macOSのactiveSpaceDidChangeでReference0=currentを通知。公開APIでSpace IDを取得できないためReference1は空 |
OnCacheSuspend |
✅ | 呼び出しゴーストのメニュー休止時に発行。描画・監視を停止し、通常イベントと進行中の応答を復帰まで待機 |
OnCacheRestore |
✅ | 休止中の呼び出しゴーストの復帰時に発行。応答を受けて描画・イベント配送を再開（実機での長時間確認は未実施） |
OnInitialize |
🟡 | セッション開始時にNOTIFY。ゴースト・SHIORI再読込時はReference0=reload。電文をテスト済み、実ゴーストの再読込確認待ち |
OnDestroy |
🟡 | 終了・SHIORI再読込前にNOTIFY、再読込時はReference0=reload。電文をテスト済み、実ゴーストの再読込確認待ち |
OnSysResume |
🟡 | macOSのスリープ復帰通知でReference0=normalを発行。自動復帰理由autoの判定は未対応 |
OnSysSuspend |
✅ | macOSがスリープへ入る直前にNOTIFY。実機スリープでの実動未確認 |
OnBasewareUpdating |
✅ | Sparkleが更新をインストールする直前に旧バージョンとビルド番号を通知 |
OnBasewareUpdated |
✅ | 更新後の初回起動で保存済みの旧版情報と現在版情報を通知 |
入力ボックスイベント
Section titled “入力ボックスイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnTeachStart |
✅ | TeachBoxを表示する直前にReferenceなしで通知。イベント生成テストで確認 |
OnTeachInputCancel |
✅ | TeachBoxをキャンセルまたは閉じた時に空のReference0とReference1=cancelを通知。イベント生成テストで確認 |
OnTeach |
✅ | 同一ゴーストセッション中の入力履歴をReference0から順に通知。イベント生成テストで確認 |
OnCommunicate |
✅ | 他ゴースト連携と入力Boxの両経路で送信元をReference0、本文をReference1へ通知。入力キャンセルはOnCommunicateInputCancelとして通知 |
OnCommunicateInputCancel |
✅ | CommunicateBoxをキャンセルまたは閉じた時に空のReference0とReference1=cancelを通知。イベント生成テストで確認 |
OnUserInput |
✅ | Onで始まらないInputBox IDの決定時にID・入力内容・補足・追加Referenceを通知 |
OnUserInputCancel |
✅ | InputBoxをキャンセル・閉じた時はclose、時間切れ時はtimeoutを理由としてID・補足とともに通知 |
inputbox.autocomplete |
✅ | inputbox・teachbox・communicatebox展開時に種類とIDを通知し、バイト値1区切りの応答を重複除去してmacOS候補入力欄へ反映。実ゴーストでの操作確認は未実施 |
ダイアログボックスイベント
Section titled “ダイアログボックスイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSystemDialog |
✅ | open/save/folder/colorダイアログの決定時に種別・ID・選択パスまたはRGB値をReference0〜2へ通知。Onで始まるIDは指定イベントとして通知 |
OnSystemDialogCancel |
✅ | open/save/folder/colorダイアログのキャンセル時に種別・IDをReference0〜1へ通知 |
OnConfigurationDialogHelp |
✅ | 本体設定のヘルプボタンから現在の設定ページIDを通知 |
OnGhostTermsAccept |
✅ | terms.txtの利用規約ダイアログで同意した時に通知。UTF-8とShift_JISを読込 |
OnGhostTermsDecline |
✅ | terms.txtの利用規約ダイアログで拒否した時に通知 |
時間イベント
Section titled “時間イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSecondChange |
✅ | 毎秒Reference0〜4を通知。会話不能時もGETで送り、NOTIFYに切り替えていません |
OnMinuteChange |
✅ | 分の変化ごとにReference0〜4を通知。会話不能時は応答を無視するがSHIORIメソッドはGETのまま |
OnHourTimeSignal |
✅ | 正時後、会話可能になるまで保留してReference0〜4を通知。実時間での実動未確認 |
消滅イベント
Section titled “消滅イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnVanishSelecting |
✅ | コンテンツエクスプローラまたは確認付きvanishbymyselfから、確認画面を出す前に発行。実画面での一連操作は未確認 |
OnVanishSelected |
✅ | 確認後または即時vanishbymyselfで、SHIORI終了前に発行して応答スクリプトを再生。実画面での一連操作は未確認 |
OnVanishCancel |
✅ | 消滅確認をキャンセルした時に発行して応答スクリプトを再生。実画面での一連操作は未確認 |
OnVanishButtonHold |
✅ | OnVanishSelected再生中のバルーンをダブルクリックした時にスクリプト・操作scope・タグ込みの中断文字位置を通知し、再生と消滅処理を取り消す。日本語とタグを含む位置をテスト済み、実ゴーストでの操作確認待ち |
OnVanished |
✅ | 消滅後の切り替え先へ消滅元の本体名・最終スクリプト・ゴースト名と切替先シェル名をReference0〜2・7で通知し、無応答ならOnBootへフォールバック。テスト済み |
OnOtherGhostVanished |
✅ | 呼び出しゴーストの消滅後、他の起動中ゴーストへReference0〜2・7を発行し、204時はOnVanishedへフォールバック。実画面での一連操作は未確認 |
選択肢イベント
Section titled “選択肢イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnChoiceSelect |
✅ | 通常選択肢のIDをReference0、追加引数をReference1以降へ渡す。OnChoiceSelectExが無応答の時だけ続けて発行 |
OnChoiceSelectEx |
✅ | 選択肢ラベル・ID・追加引数をReference0以降へ通知し、応答にトークがあれば通常OnChoiceSelectを抑制。Playerテストで確認 |
OnChoiceEnter |
✅ | 選択肢への出入りでラベル・ID・追加引数を通知し、外れた時はReferenceなし。Playerテストで確認 |
OnChoiceTimeout |
✅ | 選択肢タイムアウト時に対象スクリプト全文をReference0へ通知。Playerテストで確認 |
OnChoiceHover |
✅ | 選択肢上で1秒静止した時にラベル・ID・追加引数を通知。PlayerテストでReferenceを確認 |
OnAnchorSelect |
✅ | OnAnchorSelectExがスクリプトを返さない場合のみアンカーIDをReference0へ通知。メイン・呼び出しゴーストの両経路で対応 |
OnAnchorSelectEx |
✅ | アンカーの表示ラベル・ID・追加引数をReference0以降へ通知し、非空応答時はOnAnchorSelectを抑止。応答は割り込み再生 |
OnAnchorEnter |
✅ | アンカーへの出入りでラベル・ID・追加引数を通知し、外れた時はReferenceなし。Playerテストで確認 |
OnAnchorHover |
✅ | アンカー上で1秒静止した時にラベル・ID・追加引数を通知。PlayerテストでReferenceを確認 |
サーフェスイベント
Section titled “サーフェスイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSurfaceChange |
🟡 | surface変更をNOTIFYで送り、本体・相方IDと変更キャラクターのID・サーフェス番号・画像幅・高さを通知。追加scope・倍率をテスト済み、実ゴーストでの通知確認待ち |
OnSurfaceRestore |
✅ | SSP同様、バルーン消去15秒後に、その時点の現在surfaceをReference0〜1へ通知。待機中に次の会話が始まった場合は通知を取り消します。Playerテスト済み。Emily/Phase4.5は標準イベントを意図的に無効化し、YAYA SHIORI/3フレームワーク側の独自タイミングで復帰します |
OnOtherSurfaceChange |
✅ | set,othersurfacechangeを有効にしたゴーストへ、他ゴーストの本体名・Sakura名・scope・新旧surface・矩形をReference0〜5で通知 |
マウスイベント
Section titled “マウスイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnMouseClick |
✅ | Reference0〜6を通知。OnMouseUpが無応答の場合だけ発行する応答規則をテスト済み |
OnMouseClickEx |
✅ | 中・拡張ボタンのクリックをボタン名付きReference0〜6で通知。OnMouseUpExが無応答の場合だけ発行する応答規則をテスト済み |
OnMouseDoubleClick |
✅ | 左・右ボタンのダブルクリックをReference0〜6で通知。OnMouseUpの応答では抑止されないことを含めて自動テスト済み |
OnMouseDoubleClickEx |
✅ | 中・拡張ボタンのダブルクリックをボタン名付きReference0〜6で通知。OnMouseUpExの応答では抑止されないことを含めて自動テスト済み |
OnMouseMultipleClick |
✅ | 左・右ボタンの3連打以上を回数付きReference0〜7で通知。無応答時は奇数回をClick、偶数回をDoubleClickへ戻し、OnMouseUp応答時は通常Clickへのフォールバックだけを抑止する規則をテスト済み |
OnMouseMultipleClickEx |
✅ | 中・拡張ボタンの3連打以上を回数付きReference0〜7で通知。無応答時は通常のClickEx／DoubleClickExへ戻し、OnMouseUpEx応答時は通常ClickExへのフォールバックだけを抑止する規則をテスト済み |
OnMouseUp |
✅ | 左・右ボタンが放された時にReference0〜6を通知。応答があれば後続の通常OnMouseClickだけを抑止する規則をテスト済み |
OnMouseUpEx |
✅ | 中・拡張ボタンが放された時にボタン名付きReference0〜6で通知。応答があれば後続の通常OnMouseClickExだけを抑止する規則をテスト済み |
OnMouseDown |
✅ | 左・右ボタンが押された時に座標・scope・collision・button・入力種別を通知。入力からSHIORI変換まで自動テスト済み |
OnMouseDownEx |
✅ | 中・拡張ボタンが押された時にボタン名付きReference0〜6で通知。入力経路とSHIORI変換を自動テスト済み |
OnMouseMove |
🟡 | 移動量がcollision別の閾値を超えた時にReference0〜6を通知。SSPの全移動通知とは頻度が異なります |
OnMouseWheel |
🟡 | 座標・wheel量・scope・collision・button・入力種別を通知。gestureフォールバックは未対応 |
OnMouseEnterAll |
✅ | キャラクターウインドウへ入った時に座標・scope・collision・入力種別をReference0〜6へ通知。入力からSHIORI変換まで自動テスト済み |
OnMouseLeaveAll |
✅ | キャラクターウインドウから出た時に直前のcollisionと座標をReference0〜6へ通知。入力からSHIORI変換まで自動テスト済み |
OnMouseEnter |
🟡 | 当たり判定へ入った時に座標・scope・collision・入力種別をReference0〜6へ通知。マウス以外の入力種別は未対応 |
OnMouseLeave |
🟡 | 当たり判定から出た時に直前のcollisionと座標をReference0〜6へ通知。マウス以外の入力種別は未対応 |
OnMouseDragStart |
🟡 | 2px以上のキャラクター移動ドラッグ開始時にReference0〜6を通知。左ボタン以外のドラッグは未対応 |
OnMouseDragEnd |
🟡 | キャラクター移動ドラッグ終了時にReference0〜6を通知。左ボタン以外のドラッグは未対応 |
OnMouseHover |
✅ | キャラクター上でマウス移動が1秒止まった時にReference0〜6を通知。入力からSHIORI変換まで自動テスト済み |
OnMouseGesture |
🟡 | 右ボタンまたはホイールの8方向ドラッグと終了を、scope・現在位置／開始位置・各collision・角度とともに通知。circle.cw／circle.ccwは未対応 |
ゲームパッドイベント
Section titled “ゲームパッドイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnGamepadButtonDown |
🟡 | GameControllerの主要ボタン押下をパッド番号・ボタン名で全ゴーストへ通知。追加ボタンは未対応 |
OnGamepadButtonUp |
🟡 | GameControllerの主要ボタン解放をパッド番号・ボタン名で全ゴーストへ通知。追加ボタンは未対応 |
OnGamepadAxisMove |
🟡 | GameControllerの左右スティック変化を0.08のデッドゾーン付きで全ゴーストへ通知。トリガー軸と通知間引きは未対応 |
OnGamepadConnected |
✅ | GameController接続時と起動時の接続済みコントローラを0始まり番号で全ゴーストへ通知。実機未確認 |
OnGamepadDisconnected |
✅ | GameController切断時に割当済みパッド番号を全ゴーストへ通知。実機未確認 |
バルーンイベント
Section titled “バルーンイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnBalloonBreak |
🟡 | 通常トークを別のトークが置き換える時に、再生中スクリプト・scope・タグ込みの中断文字位置を通知。日本語・エスケープ・翻訳・埋め込み／割り込み応答をテスト済み。補助文字・結合文字のSSPとの数え方の照合と、実ゴーストでの操作確認待ち |
OnBalloonClose |
✅ | 再生完了後にユーザーがバルーンをクリックして閉じた時、表示スクリプトをReference0へ通知。Playerテストで確認 |
OnBalloonTimeout |
✅ | 選択肢のないバルーンが表示期限で閉じる時、スクリプトと残り時間0を通知。Playerテストで確認 |
トレイバルーンイベント
Section titled “トレイバルーンイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnTrayBalloonClick |
✅ | set,trayballoonをmacOSのメニューバーポップオーバーとして表示し、ポップオーバーまたはステータスアイコンのクリック時にタイトルと本文を通知 |
OnTrayBalloonTimeout |
✅ | メニューバーポップオーバーが指定時間で閉じた時にタイトルと本文を通知。指定時間はSSP互換で10〜30秒に制限 |
インストールイベント
Section titled “インストールイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnInstallBegin |
✅ | NARインストール開始前にReferenceなしで発行。実機でのゴースト応答は未確認 |
OnInstallComplete |
✅ | 各NARのOnInstallCompleteExに応答がない場合、識別子・主項目名・同梱項目名をReference0〜2へ入れて発行。実機応答は未確認 |
OnInstallCompleteEx |
✅ | 各NARのインストール後、識別子・名前・インストール先絶対パスをバイト値1区切りでReference0〜2へ通知。実機応答は未確認 |
OnInstallCompleteAll |
✅ | 複数NARがすべて成功した場合、各完了通知の後に全項目をバイト値1区切りで通知。実機応答は未確認 |
OnInstallFailure |
✅ | 静的照合ではNARインストール失敗理由をReference0へ通知。実行経路は未確認 |
OnInstallRefuse |
✅ | install.txtのaccept対象が起動していない場合、対象名・識別子・項目名をReference0〜2へ通知して拒否。実機応答は未確認 |
OnInstallReroute |
✅ | accept対象が呼び出しゴーストとして起動中なら元ゴーストへ通知し、以降の完了イベントを対象へ転送。実機応答は未確認 |
ファイルドロップイベント
Section titled “ファイルドロップイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnFileDropping |
✅ | ファイルドラッグ進入時に先頭ファイルのパスとscopeをReference0〜1へ通知。サーフェス入力からの経路とイベント生成をテスト済み |
OnFileDropped |
➖ | 旧仕様のため対象外。複数項目とMIME typeを扱えるOnFileDrop2を発行 |
OnFileDrop |
➖ | 旧仕様のため対象外。複数項目とMIME typeを扱えるOnFileDrop2を発行 |
OnFileDropEx |
➖ | 旧仕様のため対象外。複数項目とMIME typeを扱えるOnFileDrop2を発行 |
OnFileDrop2 |
✅ | 全ファイル／ディレクトリのパスとMIME typeをバイト値1区切りでReference0・2へ、scopeをReference1へ通知。複数項目の順序とMIME判定をテスト済み |
OnMediaPlayerOpen |
✅ | OnFileDrop2未応答の音声・動画を既定アプリで開いた後、同じReferenceで通知。実機応答は未確認 |
OnPictureViewerOpen |
✅ | OnFileDrop2未応答の画像を既定アプリで開いた後、同じReferenceで通知。実機応答は未確認 |
OnArchiveViewerOpen |
✅ | OnFileDrop2未応答の一般アーカイブを既定アプリで開いた後、同じReferenceで通知。NARはインストールを優先。実機応答は未確認 |
OnOtherObjectDropping |
➖ | Windows Shellの仮想オブジェクトを表すイベント。macOSのファイル・URL・テキストDnDは各専用イベントで処理 |
OnOtherObjectDropped |
➖ | Windows Shellの仮想オブジェクトを表すイベント。macOSのファイル・URL・テキストDnDは各専用イベントで処理 |
OnDirectoryDrop |
✅ | ドロップされた各ディレクトリについてパスとscopeをReference0〜1へ個別通知。混在する複数項目をテスト済み |
OnWallpaperChange |
✅ | 画像をサーフェスへドロップして全macOS画面の壁紙変更に成功した時に画像パスを通知 |
OnUpdatedataCreating |
🟡 | createupdatedataによるupdates2.dau生成の直前にReferenceなしで通知。フォルダD&Dからの作成UIは未実装 |
OnUpdatedataCreated |
✅ | updates2.dau生成成功後にReferenceなしで通知。実機応答は未確認 |
OnNarCreating |
🟡 | createnar実行直前にinstall.txt由来の名前、出力絶対パス、識別子をReference0〜2へ通知。フォルダD&Dからの作成UIは未実装 |
OnNarCreated |
✅ | NAR作成成功後に同じReference0〜2を通知。実機応答は未確認 |
URLドロップイベント
Section titled “URLドロップイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnURLDragDropping |
🟡 | Web URLがサーフェスへ重なった時にURLとscopeを通知。受入可否の詳細判定は未実装 |
OnURLDropping |
🟡 | Web URLがサーフェスへドロップされた時にURLとscopeを通知。後続のダウンロード機能は未実装 |
OnURLDropped |
✅ | NARのダウンロード完了後・インストール直前にローカルパス・元URL・scopeを通知。実ネットワークでの確認は未実施 |
OnURLDropFailure |
✅ | NAR取得失敗時に空のローカルパス、timeout・HTTP status・fileio、元URL、scopeをReference0〜3へ通知。実ネットワークでの確認は未実施 |
OnURLQuery |
🟡 | URL・scope・推定MIME type・nar/unknownを通知し、スクリプト応答時は標準処理を中止。feed・homeurl判定は未対応 |
OnXUkagakaLinkOpen |
✅ | x-ukagaka-linkをOSへ登録。eventはghost指定を本体名・キャラクター名と照合し、URLデコード済みinfoをメイン／呼び出しゴーストへ通知。installはNAR取得、homeurlは更新定義取得後のインストールへ接続 |
ネットワーク更新イベント
Section titled “ネットワーク更新イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnUpdateProcessExec |
✅ | 更新指示時にmanual・auto・scriptを通知し、応答スクリプトがあれば標準更新を中止。イベント生成テストで確認 |
OnUpdateBegin |
✅ | ゴースト名・フルパス・ghost・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateReady |
✅ | 更新対象の最終番号・ファイル名一覧・ghost・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateComplete |
✅ | none／changed・変更ファイル一覧・ghost・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateFailure |
✅ | 分類した失敗理由・失敗ファイル・ghost・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdate.OnDownloadBegin |
✅ | 取得前にファイル名・0始まり番号・最終番号・ghost・更新理由をReference0〜4へ通知。イベント生成テストで確認 |
OnUpdate.OnMD5CompareBegin |
✅ | 照合前にファイル名・期待値・実測MD5・ghost・更新理由をReference0〜4へ通知。イベント生成テストで確認 |
OnUpdate.OnMD5CompareComplete |
✅ | MD5一致時にファイル名・期待値・実測値・ghost・更新理由をReference0〜4へ通知。イベント生成テストで確認 |
OnUpdate.OnMD5CompareFailure |
✅ | MD5不一致時にファイル名・期待値・実測値・ghost・更新理由をReference0〜4へ通知して更新を中断。イベント生成テストで確認 |
OnUpdateOtherBegin |
✅ | ゴースト以外の更新開始時に名前・フルパス・対象種別・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateOtherReady |
✅ | 更新対象の最終番号・ファイル名一覧・対象種別・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateOtherComplete |
✅ | none／changed・変更ファイル一覧・対象種別・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateOtherFailure |
✅ | 分類した失敗理由・失敗ファイル・対象種別・更新理由をReference0・1・3・4へ通知。イベント生成テストで確認 |
OnUpdateOther.OnDownloadBegin |
✅ | 取得前にファイル名・0始まり番号・最終番号・対象種別・更新理由をReference0〜4へ通知。イベント生成テストで確認 |
OnUpdateOther.OnMD5CompareBegin |
✅ | 照合前にファイル名・期待値・実測MD5・対象種別・更新理由をReference0〜4へ通知。イベント生成テストで確認 |
OnUpdateOther.OnMD5CompareComplete |
✅ | MD5一致時に期待値・実測値・対象種別・更新理由をReference1〜4へ通知。イベント生成テストで確認 |
OnUpdateOther.OnMD5CompareFailure |
✅ | MD5不一致時に期待値・実測値・対象種別・更新理由をReference1〜4へ通知して更新を中断。イベント生成テストで確認 |
OnUpdateCheckComplete |
✅ | 更新チェック成功時にnone／changed・対象ファイル一覧・対象種別・Reference4=scriptを通知。イベント生成テストで確認 |
OnUpdateCheckFailure |
✅ | 更新チェック失敗時に分類した失敗理由とReference4=scriptを通知。イベント生成テストで確認 |
OnUpdateResult |
✅ | 複数対象の名前・種別・成否・件数または失敗理由・失敗パスを順番どおりReference0以降へ集約し、Exが無応答の時に通知。イベント生成テストで確認 |
OnUpdateResultEx |
✅ | 複数対象の名前・種別・成否・件数または失敗理由・失敗パスを順番どおりReference0以降へ集約して通知。イベント生成テストで確認 |
OnUpdateCheckResult |
✅ | 複数対象の更新チェック結果を順番どおりReference0以降へ集約し、Exが無応答の時に通知。イベント生成テストで確認 |
OnUpdateCheckResultEx |
✅ | 複数対象の更新チェック結果を順番どおりReference0以降へ集約して通知。イベント生成テストで確認 |
OnUpdateResultExplorer |
✅ | コンテンツエクスプローラからの単体・一括更新と修復の結果を旧形式でReference0以降へ集約して通知。イベント生成テストで確認 |
時計合わせイベント
Section titled “時計合わせイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSNTPBegin |
✅ | 時計合わせ開始時に接続先サーバをReference0へ通知。共通イベント生成をテスト済み |
OnSNTPCompareEx |
✅ | 取得時刻・ローカル時刻・符号付き秒差／ミリ秒差をReference0〜4へ通知。時刻比較とイベント生成をテスト済み |
OnSNTPCompare |
✅ | CompareExが無応答の時に従来形式へフォールバックし、絶対値の秒差／ミリ秒差を通知。時刻比較とイベント生成をテスト済み |
OnSNTPCorrectEx |
❌ | \6の要求は受理するが、macOSのシステム時刻を実際に補正する経路がなく、成功イベントは発行されない |
OnSNTPCorrect |
❌ | OnSNTPCorrectExからのフォールバック処理はあるが、実補正の成功経路がないため発行されない |
OnSNTPFailure |
✅ | HTTP接続・応答・Date解析の失敗時に接続先サーバをReference0へ通知。共通イベント生成をテスト済み |
メールチェックイベント
Section titled “メールチェックイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnBIFFBegin |
✅ | biffコマンドによるPOP3メールチェック開始時に設定アカウント名を通知 |
OnBIFFComplete |
🟡 | POP3 STAT成功時に通数・総バイト数・アカウント名・前回との差分を通知。LIST・UIDL・ヘッダ一覧は空欄 |
OnBIFF2Complete |
✅ | 新着がありOnBIFFCompleteが無応答だった場合に通数・総バイト数・アカウント名を通知 |
OnBIFFFailure |
✅ | POP3設定不足・接続・認証・応答解析失敗を理由とアカウント名付きで通知 |
ヘッドライン/RSSセンスイベント
Section titled “ヘッドライン/RSSセンスイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnHeadlinesenseBegin |
✅ | HEADLINE取得開始時にサイト名とURLをReference0〜1へ通知。イベント生成をテスト済み |
OnHeadlinesense.OnFind |
✅ | 取得項目ごとにサイト名・URL・phase・サニタイズ済み見出しをReference0〜3へ通知。イベント生成をテスト済み |
OnHeadlinesenseComplete |
✅ | 取得成功かつ更新なしの場合にReference0=no updateを通知。イベント生成をテスト済み |
OnHeadlinesenseFailure |
✅ | 取得失敗時はcan’t download、解析失敗時はcan’t analyzeをReference0へ通知。イベント生成をテスト済み |
OnRSSBegin |
✅ | サイト名・URLを通知し、無応答時はOnHeadlinesenseBeginへフォールバック。イベント生成をテスト済み |
OnRSSComplete |
✅ | フィード情報とSSP形式日時を通知。同一内容の再取得はReference0=no updateとし、無応答時はOnHeadlinesense.OnFind／Completeへフォールバック。指紋判定をテスト済み |
OnRSSFailure |
✅ | can’t download／can’t analyzeを通知し、無応答時はOnHeadlinesenseFailureへフォールバック。イベント生成をテスト済み |
カレンダーイベント
Section titled “カレンダーイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnScheduleTodayNotify |
✅ | 予定の追加・編集・削除・取り込みや日付変更で今日の予定が変化した時、全起動ゴーストへNOTIFY |
OnSchedule5MinutesToGo |
✅ | 時刻指定予定の5分前にReference0〜3へtype/caption/subtitle/scriptを通知。アプリが停止中だった期間の追跡はしません |
OnScheduleRead |
🟡 | カレンダー詳細の「予定を読む」からReference0〜3を通知。スキンアイコンのホバー読み上げは未実装 |
OnSchedulesenseBegin |
🟡 | 内蔵iCalendarセンサの読み込み開始時にReference0へファイル名、Reference1へURLを全起動ゴーストへ通知。外部calendar pluginは未対応 |
OnSchedulesenseComplete |
✅ | iCalendar読み込み完了時にReference0へ名前、Reference1へ件数を通知 |
OnSchedulesenseFailure |
✅ | iCalendarの解析・ファイル入出力失敗時にcan’t analyzeまたはcan’t downloadをReference0、センサ名をReference1へ全起動ゴーストへ通知 |
OnSchedulepostBegin |
✅ | iCalendar書き出し開始時にReference0=iCalendarで通知 |
OnSchedulepostComplete |
✅ | iCalendar書き出し成功時にReference0=iCalendarで通知。キャンセル・失敗時は完了イベントを発行しません |
SSTPイベント
Section titled “SSTPイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSSTPBreak |
🟡 | nobreakなしの新しいSSTPが再生中SSTPを中断する際に、実際の再生スクリプト・scope・タグ込みの中断文字位置を通知。予約中・完了済み・通常会話と区別するテスト済み。SSTP以外からの中断経路と、補助文字・結合文字のSSPとの数え方の照合は未完了 |
OnSSTPBlacklisting |
➖ | UKADOCではMateria専用の送信元ブラックリストイベントであり、SSP互換対象外 |
その他通信イベント
Section titled “その他通信イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnExecuteHTTPComplete |
✅ | 取得成功時に小文字のメソッド・識別ID・URL・本文または保存先・HTTPコード・Cookie・全ヘッダをReference0〜6へ通知。標準／独自イベントIDをテスト済み |
OnExecuteHTTPFailure |
✅ | HTTPステータス、timeout、fileio、artificial、toomanyredirect等をReference4へ入れ、Completeと同じReference0〜6で通知。イベント生成をテスト済み |
OnExecuteHTTPProgress |
✅ | progress-notify指定時に受信済みバイト数と期待総量をデータ受信ごとに通知 |
OnExecuteHTTPStreaming |
✅ | streaming指定時に改行単位の受信データを通知 |
OnExecuteHTTPSSLInfo |
🟡 | HTTPS通信のTLSバージョン・暗号スイート・証明書概要をURLSession metricsから通知。証明書日時は空欄 |
OnExecuteICalComplete |
✅ | ical-get／ical-postで取得したiCalendarを解析し、カレンダー情報とVEVENTをReference列へ通知。主要フィールドと件数制限に対応 |
OnExecuteICalFailure |
✅ | iCalendarの通信・HTTP・解析失敗をHTTP系と同じReference形式で通知 |
OnExecuteICalProgress |
✅ | –progress-notify指定時にiCalendar取得の進捗を通知 |
OnExecuteICal_SSLInfo |
✅ | HTTPSでiCalendarを取得した時にTLS情報を通知 |
OnExecuteRSSComplete |
✅ | RSS各項目をタイトル・URL・SSP形式日時・作者・要約のバイト値1区切りでReference0以降へ通知。標準／独自イベントIDをテスト済み |
OnExecuteRSSFailure |
✅ | 解析失敗はReference4=parse、通信失敗はHTTPと同じReference0〜6で通知。標準／独自イベントIDをテスト済み |
OnExecuteRSS_SSLInfo |
🟡 | HTTPSのRSS取得時にHTTPと同じTLS情報を通知。証明書日時は空欄 |
OnExecuteScheduleComplete |
✅ | schedule-add／schedule-deleteで共有予定表への登録・削除が完了した時に操作種別とUIDを通知 |
OnExecuteScheduleFailure |
✅ | schedule-add／schedule-deleteの入力不正・対象なしを理由とUID付きで通知 |
OnExecuteScheduleGetComplete |
✅ | schedule-getで共有予定表をiCalendarと同じReference形式で通知 |
OnExecuteFileWatchChange |
✅ | filewatchで指定したファイルまたはディレクトリの作成・更新・削除をdebounce後に通知 |
OnExecuteFileWatchFailure |
✅ | filewatchの監視先ディレクトリがない場合や監視を継続できない場合に理由を通知 |
OnExecuteWebSocketOpen |
✅ | HTTP 101成立後にReference0〜2を発行 |
OnExecuteWebSocketReceive |
✅ | text/binary opcodeと本文またはBase64をReference0〜3へ発行 |
OnExecuteWebSocketReconnect |
✅ | WebSocket受信失敗後の自動再接続を最大5回行い、試行回数を通知 |
OnExecuteWebSocketClose |
✅ | 正常終了、明示的なclose、ユーザー中断時にclose codeまたはuserbreakを通知。異常切断時は再接続へ移行 |
OnExecuteWebSocketFailure |
✅ | 接続・受信エラーから最大5回の自動再接続に失敗した時にreconnect failedを通知 |
OnExecuteWebSocket_SSLInfo |
🟡 | wss接続のTLSバージョンと暗号スイートを通知。証明書subject・issuerは空欄 |
OnPingComplete |
🟡 | ping完了を通知するがReference1の送信元アドレスとReference2以降の1応答1Reference構造が未対応 |
OnPingProgress |
✅ | pingの応答行ごとに指定イベントID・ホスト・応答番号・解析した遅延を通知 |
OnNSLookupComplete |
✅ | nslookup成功時に指定イベント名・ホスト・lookup/reverse・結果をReference0〜3へ通知。executeタグのコマンド解析とイベント生成をテスト済み |
OnNSLookupFailure |
✅ | nslookup失敗時に指定イベント名・ホスト・lookup/reverseをReference0〜2へ通知し、不要なReference3は付けない。イベント生成をテスト済み |
イベント送信失敗イベント
Section titled “イベント送信失敗イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnRaisePluginFailure |
✅ | raisepluginの対象未発見・無効・非200・実行例外時に、理由・対象・イベント・元Referenceを通知し、応答スクリプトを反映 |
OnNotifyPluginFailure |
✅ | notifypluginの対象未発見・無効・非200・実行例外時に、理由・対象・イベント・元ReferenceをNOTIFY相当で通知 |
OnRaiseOtherFailure |
🟡 | raiseotherの宛先がない時はnotfound、宛先SHIORIが204の時は204をReference0へ入れ、宛先・イベントID・元Referenceとともに送信元へ通知。全ゴースト宛ての複数結果列挙は未対応 |
OnNotifyOtherFailure |
🟡 | notifyotherの宛先がない時にnotfoundをReference0へ入れ、宛先・イベントID・元Referenceとともに送信元へ通知。全ゴースト宛ての複数結果列挙は未対応 |
見切れ・重なりイベント
Section titled “見切れ・重なりイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnOverlap |
✅ | 同一ゴースト内の表示中サーフェス同士の重なり状態が変化した時、現在と直前のscope組を通知 |
OnOtherOverlap |
✅ | 呼び出しゴーストを含む全表示サーフェスの重なり状態が変化した時、現在と直前のSakura名/scope組を通知 |
OnOffscreen |
✅ | サーフェスが全画面の作業領域内に収まるかを1秒ごとに確認し、状態変化時に現在と直前のscope一覧を通知 |
OnOtherOffscreen |
✅ | 呼び出しゴーストを含む見切れ状態の変化時、現在と直前のSakura名/scope一覧を通知 |
ネットワーク状態イベント
Section titled “ネットワーク状態イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnNetworkHeavy |
🟡 | SakuraScriptのHTTP/RSS要求が設定時間でタイムアウトした時、設定秒数と経過秒数を通知。HEADLINEや更新通信は未接続 |
OnNetworkStatusChange |
✅ | Network.frameworkで起動時と接続状態変化時にonline/offline・IP一覧・wifi/ethernet/cellular等・従量制状態を通知。通信速度は0 |
OS状態イベント
Section titled “OS状態イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnScreenSaverStart |
✅ | macOS分散通知でスクリーンセーバ開始を検出。名称は固定、実行ファイルと待ち時間は空欄 |
OnScreenSaverEnd |
✅ | macOS分散通知でスクリーンセーバ終了を検出。名称は固定、実行ファイルと待ち時間は空欄 |
OnSessionLock |
✅ | macOSユーザーセッションが非アクティブになった時に通知。実機ロックでの実動未確認 |
OnSessionUnlock |
✅ | macOSユーザーセッションが再びアクティブになった時に通知。実機ロック解除での実動未確認 |
OnSessionDisconnect |
✅ | macOSユーザーセッションが非アクティブになった時にLockと併せて通知。簡易ユーザー切替と画面ロックを区別しません |
OnSessionReconnect |
✅ | macOSユーザーセッションがアクティブへ戻った時にUnlockと併せて通知。簡易ユーザー切替と画面ロックを区別しません |
OnCPULoadHigh |
✅ | OS全体のCPU使用率が80%以上で5秒間隔3回続いた時に現在率をReference0へ通知。状態遷移テストで確認 |
OnCPULoadLow |
✅ | CPU High通知後に使用率が60%未満へ戻った時、現在率をReference0へ通知。状態遷移テストで確認 |
OnMemoryLoadHigh |
✅ | VM統計のメモリ使用率が80%以上で5秒間隔3回続いた時に現在率をReference0へ通知。状態遷移テストで確認 |
OnMemoryLoadLow |
✅ | Memory High通知後に使用率が60%未満へ戻った時、現在率をReference0へ通知。状態遷移テストで確認 |
OnDisplayChange |
🟡 | 起動時NOTIFY、画面構成・ウインドウモード・コンテナ表示領域の変更時GETで、そのゴーストの表示領域のbpp・幅・高さを通知。共有／個別ウインドウの通知先と生成処理をテスト済み、実機での画面変更確認待ち |
OnDisplayHandover |
✅ | シェル位置の初期化時と別スクリーンへの移動時に、scopeと移動前後の画面座標・色深度・主画面フラグを通知 |
OnDisplayChangeEx |
🟡 | 起動時init/NOTIFY、画面構成・ウインドウモード・コンテナ表示領域の変更時update/GET。上原点の画面矩形・色深度・プライマリ判定を通知し、末尾はunknown,0。ウインドウモード中は実モニター変更を通知せず、コンテナの最終レイアウトを通知。配送・重複抑止をテスト済み、実機確認待ち |
OnDisplayPowerStatus |
✅ | macOSのスリープ直前に0、復帰時に1を通知。単独ディスプレイの電源断は検出しません |
OnBatteryNotify |
✅ | 起動時と30秒ごとの状態変化時に残量・残り分数・給電状態・状態フラグを通知。バッテリーなしもno_batteryとして通知 |
OnBatteryLow |
✅ | 残量が33%以下へ遷移した時にOnBatteryNotifyと同じReferenceを通知 |
OnBatteryCritical |
✅ | 残量が5%以下へ遷移した時にOnBatteryNotifyと同じReferenceを通知 |
OnBatteryChargingStart |
✅ | 充電状態への遷移時にOnBatteryNotifyと同じReferenceを通知 |
OnBatteryChargingStop |
✅ | 非充電状態への遷移時にOnBatteryNotifyと同じReferenceを通知 |
OnDeviceArrival |
✅ | macOSでボリュームがマウントされた時、volume・名前・空の製造者・パスをバイト値1区切りで通知。一般USB機器は対象外 |
OnDeviceRemove |
✅ | macOSでボリュームがアンマウントされた時、OnDeviceArrivalと同形式で通知。一般USB機器は対象外 |
OnTabletMode |
➖ | macOSに対応するタブレットモードがないため対象外 |
OnDarkTheme |
✅ | 起動時とアプリ再アクティブ化時にmacOSのダークモード状態をReference0〜1へ通知。非アクティブ中の変更は復帰時通知 |
OnDesktopWallpaperChange |
✅ | 起動時はNOTIFY、macOSの壁紙変更時はGETで、画面・画像パス・表示方法・背景色を通知。状態遷移とReferenceを自動テスト済み |
OnWindowModeChange |
✅ | 起動時とウインドウモード切替時に現在・直前のモードを通知し、切替時はOnDisplayChangeも発行 |
OnOSUpdateInfo |
✅ | macOSのsystem_profilerインストール履歴から直近20件の名称・版・導入日を起動時に通知。Windows固有項目は空欄 |
OnRecycleBinEmpty |
✅ | emptyrecyclebinでユーザーの~/.Trashを空にし、前後の件数・容量と成否を通知 |
OnRecycleBinEmptyFromOther |
✅ | 他ゴーストがemptyrecyclebinを実行した時に同じ結果を通知 |
OnRecycleBinStatusUpdate |
✅ | 起動時と5秒ごとの変化時にmacOSゴミ箱内の通常ファイル数・合計サイズ・直前との差を通知。外部ボリュームのゴミ箱と隠しファイルは対象外 |
選択領域モードイベント
Section titled “選択領域モードイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSelectModeBegin |
✅ | enter,selectrectで全画面の矩形選択オーバーレイを開始して通知 |
OnSelectModeCancel |
✅ | selectrectをEscまたは選択未完了で終了した時に通知 |
OnSelectModeComplete |
✅ | leave,selectrectで選択矩形の画面座標を通知 |
OnSelectModeMouseDown |
✅ | 矩形選択開始点をクリックした時にscope・モード・画面座標を通知 |
OnSelectModeMouseUp |
✅ | 矩形選択終了点でボタンを離した時にscope・モード・画面座標を通知 |
音声認識・合成イベント
Section titled “音声認識・合成イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnSpeechSynthesisStatus |
✅ | 起動時と音声合成のON/OFF時に有効状態を通知 |
OnVoiceRecognitionStatus |
✅ | 起動時とmacOS音声認識のON/OFF時に有効状態を通知 |
OnVoiceRecognitionWord |
✅ | 確定した認識結果だけを通知。キャラクター名と完全一致した場合は対応scopeをReference0に設定 |
その他イベント
Section titled “その他イベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
OnKeyPress |
✅ | Utataneがアクティブな時のkeyDownを文字・macOS keyCode・repeat・scope・修飾キーで通知。Reference1はWin32仮想キーコードではありません |
OnRecommendsiteChoice |
✅ | おすすめ・ポータルメニュー選択時にサイト名・URL・バナー・種別・選択scope・0始まりの位置をReference0〜5へ通知。イベント生成テストで確認 |
OnTranslate |
✅ | イベント応答の再生前に元スクリプト・イベントID・Reference等で同じSHIORIを再呼出しし、応答があれば置換 |
OnAITalk |
✅ | \a・手動ランダムトークからGETで発行。Referenceなし |
OnOtherGhostTalk |
✅ | set,otherghosttalkでopt-inしたゴーストへ他ゴーストの再生前または再生後のスクリプトと発生元情報を通知 |
OnEmbryoExist |
➖ | Windows用Materiaの同時起動検出イベントでありmacOS版では対象外 |
OnNekodorifExist |
➖ | Windows用猫どりふの同時起動検出イベントでありmacOS版では対象外 |
OnSoundStop |
✅ | SakuraScript音声の自然終了とstop操作でファイル名・end/closeを通知。ループ終了など全経路は未確認 |
OnSoundLoop |
✅ | SakuraScriptのループ音声が末尾から次の周回へ入るたびにファイル名をReference0へ通知。周回・終了・失敗の判定を自動テスト済み |
OnSoundError |
✅ | 音声ファイル解決・AVAudioPlayer生成・再生終了失敗時にplay・エラーコード・ファイル・説明を通知。実動未確認 |
OnMusicPlayEx |
✅ | 設定有効時、ブラウザ以外の曲変更を検出して通知。無反応ならOnMusicPlayへフォールバック。判定不能な再生元もこちらへ送る。実アプリでの通知は未確認 |
OnMusicPlay |
✅ | 拡張イベントへの無反応時にタイトル・アーティストを通知。SSTP/1.1のSongヘッダ経路も対応 |
OnVideoPlayEx |
✅ | MediaRemoteの親アプリまたは再生クライアントのbundle IDから主要ブラウザを判定し、動画・音楽を共通Referenceで通知。メイン・呼び出しゴーストの両経路へ接続済み。実ブラウザでの通知は未確認 |
OnTextDrop |
✅ | サーフェスへのテキストDnDで改行をバイト値1に変換し本文とscopeを通知。イベント生成テストで確認 |
OnShellScaling |
✅ | 設定でシェル倍率が変わった時に新旧の縦横パーセントをReference0〜3へ通知。Utataneの倍率設定は縦横同値 |
OnBalloonScaling |
✅ | 設定でバルーン倍率が変わった時に新旧の縦横パーセントをReference0〜3へ通知。Utataneの倍率設定は縦横同値 |
OnLanguageChange |
🟡 | 起動時に現在の言語名とLocale IDをReference0〜1へ通知。実行中の言語変更監視とUtatane言語フォルダ・ヘルプURLは未対応 |
OnResetWindowPos |
🟡 | メニュー操作でGETを送り、空でない返答を再生。無応答・空文字列なら標準のシェル・バルーン位置初期化へ進む。分岐をテスト済み、メニュー実操作は確認待ち |
OnExtractArchiveComplete |
✅ | 実際のZIP展開成功後に書庫・出力先・形式・ユーザーIDをReference0〜3へ通知。展開処理とイベント生成をテスト済み |
OnExtractArchiveFailure |
✅ | ZIP展開失敗時に対象書庫とエラー内容をReference0〜1へ通知。失敗経路とイベント生成をテスト済み |
OnCompressArchiveComplete |
✅ | 実際のZIP圧縮成功後にファイル・出力先・形式・ユーザーIDをReference0〜3へ通知。圧縮処理とイベント生成をテスト済み |
OnCompressArchiveFailure |
✅ | ZIP圧縮失敗時に対象ファイルとエラー内容をReference0〜1へ通知。失敗経路とイベント生成をテスト済み |
property.get |
✅ | activeghostlist.extの対象ゴーストへ拡張プロパティ取得を中継 |
property.set |
✅ | activeghostlist.extの対象ゴーストへ拡張プロパティ設定を中継 |
Notifyイベント
Section titled “Notifyイベント”| イベント | 状況 | Utataneの挙動・差分 |
|---|---|---|
basewareversion |
✅ | 起動時にUtataneの表示バージョン・本体名・ビルド番号をNOTIFY。SSPの数値形式との完全一致は未確認 |
hwnd |
✅ | 起動時に各scopeのNSWindow番号をバイト値1区切りでNOTIFY。macOSのwindowNumberでありWindows HWNDではなく、未生成バルーンは空欄 |
uniqueid |
✅ | 起動時にゴーストのインストールディレクトリ名を一意IDとしてNOTIFY。SSTPでの利用は未確認 |
capability |
🟡 | 起動時にUtataneが扱う主要SHIORIリクエスト・レスポンスヘッダをNOTIFY。拡張ヘッダの網羅は未対応 |
ownerghostname |
✅ | 起動時に現在のゴースト名をReference0へNOTIFY |
otherghostname |
✅ | 起動時に呼び出し起動中の他ゴースト名とscope 0/1のsurface番号をバイト値1区切りでNOTIFY。通常起動側から見える呼出ゴーストのみ |
installedsakuraname |
✅ | 起動時に全インストール済みゴーストのscope 0名を同一順序のReference列へNOTIFY |
installedkeroname |
✅ | 起動時に全インストール済みゴーストのscope 1名を同一順序のReference列へNOTIFY |
installedghostname |
✅ | 起動時に全インストール済みゴースト名をReference列へNOTIFY |
installedshellname |
✅ | 起動中ゴーストにインストールされたシェル名をReference列へNOTIFY。他ゴーストのシェルは含めません |
installedballoonname |
✅ | 起動時に全インストール済みバルーン名をReference列へNOTIFY |
installedheadlinename |
✅ | 起動時に全インストール済みRSS・ヘッドライン名をReference列へNOTIFY |
installedcalendarskinname |
✅ | 起動時に利用可能なカレンダースキン名をReference列へNOTIFY |
installedcalendarpluginname |
✅ | 起動時に空のNOTIFYを送り、利用可能な外部カレンダープラグインがない状態を通知 |
installedplugin |
✅ | 起動時に認識済みプラグインの「名前、ID」をバイト値1で結合し、Reference列へNOTIFY。ネイティブSHIORI型のロード、定期イベント、メニュー・SakuraScript明示呼び出しを接続 |
configuredbiffname |
✅ | 起動時に本体設定で利用可能なPOP3アカウント名をNOTIFY。パスワードはmacOS Keychainへ保存 |
ghostpathlist |
✅ | 起動時に有効な全ゴーストフォルダの絶対パスを優先順でNOTIFY。DebugではBundledも含みます |
balloonpathlist |
✅ | 起動時に有効な全バルーンフォルダの絶対パスを優先順でNOTIFY。DebugではBundledも含みます |
headlinepathlist |
✅ | 起動時に有効な全ヘッドラインフォルダの絶対パスを優先順でNOTIFY |
pluginpathlist |
✅ | 起動時に有効な全プラグインフォルダの絶対パスを優先順でNOTIFY。DebugではLocalも含みます |
calendarskinpathlist |
✅ | 起動時にカレンダースキン格納パスをNOTIFY |
calendarpluginpathlist |
✅ | 起動時にカレンダープラグイン格納パスをNOTIFY |
rateofusegraph |
🟡 | 起動中ゴーストをboot状態の1レコードとしてNOTIFY。起動回数・時間・割合は0固定で履歴集計は未実装 |
enable_log |
✅ | 起動時にUtataneのアプリ内ログが有効であることをReference0=1でNOTIFY。Utataneでは実行中の切替UIを提供しない |
enable_debug |
✅ | 起動時にDebugビルドなら1、Releaseなら0をReference0へNOTIFY。Utataneでは実行中の切替UIを提供しない |
OnNotifySelfInfo |
✅ | 起動時にゴースト・キャラクター・シェル・バルーンの名前と絶対パスをReference0〜6へNOTIFY |
OnNotifyBalloonInfo |
🟡 | 起動時にバルーン名・絶対パス・sakura/kero/追加キャラクターの画像番号をNOTIFY。画像以外を除く列挙をテスト済み、実ゴーストへの通知確認待ち |
OnNotifyShellInfo |
✅ | 起動時にシェル名・絶対パス・定義済みsurface番号一覧をReference0〜2へNOTIFY |
OnNotifyDressupInfo |
🟡 | 起動時NOTIFY、着せ替え操作後GETで全着せ替え情報をバイト値1区切りで通知し、返答を利用。生成・送信順・応答処理をテスト済み、実ゴーストでの操作確認待ち |
OnNotifyUserInfo |
✅ | 起動時にmacOSアカウント名とフルネームを通知。誕生日は空、性別はundef固定 |
OnNotifyOSInfo |
✅ | 起動時にmacOS・CPUコア数・物理メモリ・uptimeをReference0〜3へNOTIFY。CPUクロックと仮想メモリは概算値 |
OnNotifyFontInfo |
🟡 | 起動時にmacOSで利用可能なフォント名をReference列へNOTIFY。フォント変更の動的再通知は未対応 |
OnNotifyInternationalInfo |
✅ | 起動時にUTC時差・夏時間・国・言語コードをReference0〜3へNOTIFY。Locale未設定時は空欄 |
- 実装または調査時に、発生条件・Reference・GET/NOTIFY・応答利用の4点を確認します。
- ✅へ変更する場合は、テストまたは実機確認の根拠を備考に残します。
- UKADOC側の増減確認には生成スクリプトを使い、既存の手動判定を上書きしないよう差分を確認します。
- 外部からのSHIORI EventとSHIORI Resourceは、この表とは分けて管理します。