@uzuhq/code-sdk 0.8.8 → 0.8.10

package/README.md

@@ -296,6 +296,24 @@ changeRoom(null); // デフォルトルーム（全員が同じ音声チャン
 - 初期状態ではすべてのプレイヤーがデフォルトルーム（`null`）に所属する
 - `roomId` に文字列を指定すると、そのプレイヤーは指定ルームへ移動する
 
+### `finishGame(): void`
+
+ゲームを終えて、この端末のプレイ画面を閉じる。ホストはイベントを終了扱いにし、呼んだプレイヤーを退出させる。
+
+```ts
+import { finishGame } from '@uzuhq/code-sdk';
+
+onState(state) {
+  if (state.debriefClosed) finishGame();
+}
+```
+
+- 結果や感想戦を見終えて閉じるときに呼ぶ。勝敗が決まった瞬間 (`gameover` など) に呼ぶと、結果を見る前に画面が閉じる
+- 途中退出は UZU メニューの「退出」が担うので、ゲーム内の exit / quit ボタンには使わない
+- 閉じるのは呼んだ端末だけ。全員を閉じたいときは、終了を表す state を全員へ配り、各端末で呼ぶ
+- 再描画のたびに呼んでもよい (ホストは処理中の 2 回目以降を無視する)
+- 対応していない古いアプリや `uzu dev` では何も起きないので、呼んだあとも画面を操作不能にしない
+
 ### `onPlayersChanged(handler: (players: Record<string, PlayerVoiceState>) => void): void`
 
 プレイヤーのリアルタイム状態（音声状態）が変化したときのハンドラを登録する。

package/dist/dev-globals.d.ts

@@ -1,4 +1,4 @@
-import { r as UzuDevHooks } from "./dev-hooks-B9mpXwaP.js";
+import { r as UzuDevHooks } from "./dev-hooks-7UDN8Xac.js";
 //#region src/dev-globals.d.ts
 declare global {
   interface Window {