130 lines
2.8 KiB
TypeScript
130 lines
2.8 KiB
TypeScript
/**
|
|
* 抓大鹅 Match3D 运行态共享契约。
|
|
* 前端可以使用 Flying 做即时表现；后端权威快照只应返回 InBoard、InTray、Cleared。
|
|
*/
|
|
export type Match3DRunStatus =
|
|
| 'running'
|
|
| 'won'
|
|
| 'failed'
|
|
| 'stopped'
|
|
| 'Running'
|
|
| 'Won'
|
|
| 'Failed'
|
|
| 'Stopped'
|
|
| string;
|
|
export type Match3DItemState =
|
|
| 'in_board'
|
|
| 'in_tray'
|
|
| 'cleared'
|
|
| 'InBoard'
|
|
| 'Flying'
|
|
| 'InTray'
|
|
| 'Cleared'
|
|
| string;
|
|
export type Match3DFailureReason =
|
|
| 'time_up'
|
|
| 'tray_full'
|
|
| 'TimeUp'
|
|
| 'TrayFull'
|
|
| string;
|
|
export type Match3DClickRejectReason =
|
|
| 'run_not_active'
|
|
| 'snapshot_version_mismatch'
|
|
| 'item_not_found'
|
|
| 'item_not_in_board'
|
|
| 'item_not_clickable'
|
|
| 'tray_full'
|
|
| string;
|
|
|
|
export type Match3DClickConfirmStatus =
|
|
| 'Accepted'
|
|
| 'RejectedNotClickable'
|
|
| 'RejectedAlreadyMoved'
|
|
| 'RejectedTrayFull'
|
|
| 'VersionConflict'
|
|
| 'RunFinished';
|
|
|
|
export interface StartMatch3DRunRequest {
|
|
profileId: string;
|
|
}
|
|
|
|
export interface Match3DClickItemRequest {
|
|
runId?: string;
|
|
itemInstanceId: string;
|
|
clientActionId?: string;
|
|
snapshotVersion?: number;
|
|
clientSnapshotVersion: number;
|
|
clientEventId: string;
|
|
clickedAtMs: number;
|
|
}
|
|
|
|
export type ClickMatch3DItemRequest = Match3DClickItemRequest;
|
|
|
|
export interface StopMatch3DRunRequest {
|
|
clientActionId: string;
|
|
}
|
|
|
|
export interface Match3DItemSnapshot {
|
|
itemInstanceId: string;
|
|
itemTypeId: string;
|
|
visualKey: string;
|
|
x: number;
|
|
y: number;
|
|
radius: number;
|
|
layer: number;
|
|
state: Match3DItemState;
|
|
clickable: boolean;
|
|
traySlotIndex?: number | null;
|
|
}
|
|
|
|
export interface Match3DTraySlot {
|
|
slotIndex: number;
|
|
itemInstanceId?: string | null;
|
|
itemTypeId?: string | null;
|
|
visualKey?: string | null;
|
|
}
|
|
|
|
export interface Match3DRunSnapshot {
|
|
runId: string;
|
|
profileId: string;
|
|
ownerUserId?: string;
|
|
status: Match3DRunStatus;
|
|
snapshotVersion: number;
|
|
startedAtMs: number;
|
|
durationLimitMs: number;
|
|
serverNowMs?: number;
|
|
remainingMs: number;
|
|
clearCount: number;
|
|
totalItemCount: number;
|
|
clearedItemCount: number;
|
|
boardVersion?: number;
|
|
items: Match3DItemSnapshot[];
|
|
traySlots: Match3DTraySlot[];
|
|
failureReason?: Match3DFailureReason | null;
|
|
lastConfirmedActionId?: string | null;
|
|
}
|
|
|
|
export interface Match3DClickConfirmation {
|
|
accepted: boolean;
|
|
rejectReason?: Match3DClickRejectReason | null;
|
|
enteredSlotIndex?: number | null;
|
|
clearedItemInstanceIds: string[];
|
|
run: Match3DRunSnapshot;
|
|
}
|
|
|
|
export interface Match3DClickItemResult {
|
|
status: Match3DClickConfirmStatus;
|
|
run: Match3DRunSnapshot;
|
|
acceptedItemInstanceId?: string;
|
|
clearedItemInstanceIds: string[];
|
|
failureReason?: Match3DFailureReason | null;
|
|
}
|
|
|
|
export interface Match3DRunResponse {
|
|
run: Match3DRunSnapshot;
|
|
}
|
|
|
|
export interface Match3DClickResponse {
|
|
confirmation: Match3DClickConfirmation;
|
|
}
|