@uzuhq/code-sdk 0.8.10 → 0.8.12

package/README.md

@@ -296,6 +296,21 @@ changeRoom(null); // デフォルトルーム（全員が同じ音声チャン
 - 初期状態ではすべてのプレイヤーがデフォルトルーム（`null`）に所属する
 - `roomId` に文字列を指定すると、そのプレイヤーは指定ルームへ移動する
 
+### `haptic(kind: 'light' | 'medium' | 'heavy'): void`
+
+端末を短く振動させる。アプリ内では `navigator.vibrate` が効かないので、代わりにこれを使う。
+
+```ts
+import { haptic } from '@uzuhq/code-sdk';
+
+haptic('light'); // 手がかり入手など
+haptic('heavy'); // 画面が揺れる演出など
+```
+
+- 長さは指定できない（iOS の触覚は種類でしか選べないため、段階で渡す）
+- 端末の設定で触覚を切っている人には効かない
+- ブラウザで単独で開いたときは `navigator.vibrate` にフォールバックする
+
 ### `finishGame(): void`
 
 ゲームを終えて、この端末のプレイ画面を閉じる。ホストはイベントを終了扱いにし、呼んだプレイヤーを退出させる。

package/dist/index.d.ts

@@ -198,6 +198,20 @@ declare const playBgm: (sound: string) => void;
 declare const stopBgm: () => void;
 declare const setMicEnabled: (enabled: boolean) => void;
 declare const changeRoom: (roomId: string | null) => void;
+/**
+ * 振動の強さ。
+ *
+ * ミリ秒ではなく段階で渡すのは、iOS の触覚が長さを指定できず種類で選ぶ仕組みだから。
+ * 段階なら iOS / Android で同じ意味になる。
+ */
+type HapticKind = 'light' | 'medium' | 'heavy';
+/**
+ * 端末を短く振動させる。
+ *
+ * アプリの WebView では `navigator.vibrate` が効かない (iOS には Web から振動させる手段が
+ * 無い) ので、ホストへ依頼する。端末の設定で触覚を切っている人には OS 側で効かない。
+ */
+declare const haptic: (kind: HapticKind) => void;
 /**
  * splash 描画完了を Flutter ホストに通知する。
  *
@@ -266,4 +280,4 @@ declare const onPlayersChanged: (handler: PlayersChangedHandler) => void;
  */
 declare const run: <S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = Record<never, never>>(config: GameConfig<S, A, SA>) => void;
 //#endregion
-export { type ActionArgs, type ActionContext, type ActionHandler, type ActionMap, type BridgeChannel, type BridgeMessage, type ConnectionCallbacks, type ConnectionState, DEFAULT_ICON_URLS, type Deadline, type DeadlineArgs, type DeadlineContext, type DevHooksCtx, type Duration, type Emit, type EventHandler, type EventSubscription, GAME_START, type GameConfig, type GameLogic, type GameTime, type Insets, type JsonMergePatch, type JsonPatchOp, type Operation, type PayloadMap, type PlayScreenMessage, type PlayerVoiceState, type PlayersChangedMessage, type PredictionWarning, type ReconnectableWSOptions, ReconnectableWebSocket, type RunHandle, type Seat, type SeatKind, type SeededRandom, SeededRandomImpl, type SendAction, type ServerActionArgs, type ServerActionContext, type ServerActionHandler, type ServerActionMap, type ServerEvent, type ServerOnlyAction, type ServerOnlyActionContext, type ServerOnlyActionHandlerFn, type SetupArgs, type SetupContext, type UpdateArgs, type UpdateContext, type UzuDevHooks, type UzuInsets, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, finishGame, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };
+export { type ActionArgs, type ActionContext, type ActionHandler, type ActionMap, type BridgeChannel, type BridgeMessage, type ConnectionCallbacks, type ConnectionState, DEFAULT_ICON_URLS, type Deadline, type DeadlineArgs, type DeadlineContext, type DevHooksCtx, type Duration, type Emit, type EventHandler, type EventSubscription, GAME_START, type GameConfig, type GameLogic, type GameTime, HapticKind, type Insets, type JsonMergePatch, type JsonPatchOp, type Operation, type PayloadMap, type PlayScreenMessage, type PlayerVoiceState, type PlayersChangedMessage, type PredictionWarning, type ReconnectableWSOptions, ReconnectableWebSocket, type RunHandle, type Seat, type SeatKind, type SeededRandom, SeededRandomImpl, type SendAction, type ServerActionArgs, type ServerActionContext, type ServerActionHandler, type ServerActionMap, type ServerEvent, type ServerOnlyAction, type ServerOnlyActionContext, type ServerOnlyActionHandlerFn, type SetupArgs, type SetupContext, type UpdateArgs, type UpdateContext, type UzuDevHooks, type UzuInsets, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, finishGame, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, haptic, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };

package/dist/index.js

@@ -1293,6 +1293,35 @@ const onInsetsChange = (cb) => {
 	};
 };
 //#endregion
+//#region src/bridge-envelope.ts
+const isBridgeChannel = (value) => value === "sdk" || value === "game";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+* 親 frame から postMessage で届く envelope を BridgeMessage に復元する。
+* string でも object でも来るので、形を確かめてから通す。
+*
+* payload を欠いた envelope は `{}` で埋める。受け手の handleMessage は
+* `payload.players` のように payload を直に読むので、ここで落とすと
+* 例外やハンドラへの `undefined` 渡しになる。
+*/
+const parseBridgeEnvelope = (raw) => {
+	let value = raw;
+	if (typeof value === "string") try {
+		value = JSON.parse(value);
+	} catch {
+		return null;
+	}
+	if (!isRecord(value)) return null;
+	const { channel, type, payload, playerId } = value;
+	if (!isBridgeChannel(channel) || typeof type !== "string") return null;
+	return {
+		channel,
+		type,
+		payload: isRecord(payload) ? payload : {},
+		...typeof playerId === "string" ? { playerId } : {}
+	};
+};
+//#endregion
 //#region src/scenario-callback.ts
 /**
 * @docs
@@ -2031,6 +2060,24 @@ const setMicEnabled = (enabled) => {
 const changeRoom = (roomId) => {
 	sendRaw("sdk", "changeRoom", { roomId });
 };
+const HAPTIC_FALLBACK_MS = {
+	light: 10,
+	medium: 20,
+	heavy: 30
+};
+/**
+* 端末を短く振動させる。
+*
+* アプリの WebView では `navigator.vibrate` が効かない (iOS には Web から振動させる手段が
+* 無い) ので、ホストへ依頼する。端末の設定で触覚を切っている人には OS 側で効かない。
+*/
+const haptic = (kind) => {
+	if (!isHosted) {
+		if ("vibrate" in navigator) navigator.vibrate(HAPTIC_FALLBACK_MS[kind]);
+		return;
+	}
+	sendRaw("sdk", "haptic", { kind });
+};
 /**
 * splash 描画完了を Flutter ホストに通知する。
 *
@@ -2178,22 +2225,6 @@ const sendRaw = (channel, type, payload) => {
 	if (window.FlutterHost) window.FlutterHost.postMessage(JSON.stringify(msg));
 	else if (window.parent !== window) window.parent.postMessage(JSON.stringify(msg), "*");
 };
-/** 親 frame から届く envelope。string でも object でも来るので、形を確かめてから通す。 */
-const parseBridgeEnvelope = (raw) => {
-	let value = raw;
-	if (typeof value === "string") try {
-		value = JSON.parse(value);
-	} catch {
-		return null;
-	}
-	if (typeof value !== "object" || value === null) return null;
-	const envelope = value;
-	if (typeof envelope.channel !== "string" || typeof envelope.type !== "string") return null;
-	return {
-		channel: envelope.channel,
-		type: envelope.type
-	};
-};
 const handleMessage = (msg) => {
 	const { channel, type, payload } = msg;
 	if (channel === "sdk") {
@@ -2226,4 +2257,4 @@ const handleMessage = (msg) => {
 	for (const fn of h) callScenario(`game/${type} ハンドラ`, () => fn(payload));
 };
 //#endregion
-export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, finishGame, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };
+export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, finishGame, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, haptic, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzuhq/code-sdk",
-  "version": "0.8.10",
+  "version": "0.8.12",
   "description": "UZU PlayScreen SDK - Flutter ↔ JS ゲーム通信ライブラリ",
   "type": "module",
   "exports": {