zhangyan/cmr-mini
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

整理文档并接入 H5 体验测试链路

Browse Source
This commit is contained in:
zhangyan
2026-03-27 15:36:27 +08:00
parent 0e025c3426
commit 0e0a724025
55 changed files with 4177 additions and 55 deletions
Download Patch File Download Diff File Expand all files Collapse all files

47
miniprogram/game/content/courseToGameDefinition.ts
View File

@@ -1,4 +1,6 @@
import {
type GameContentExperienceConfig,
type GameContentExperienceConfigOverride,
type GameDefinition,
type GameControl,
type GameControlDisplayContent,
@@ -19,6 +21,35 @@ function buildDisplayBody(label: string, sequence: number | null): string {
return label
}
function applyExperienceOverride(
baseExperience: GameContentExperienceConfig | null,
override: GameContentExperienceConfigOverride | undefined,
): GameContentExperienceConfig | null {
if (!override) {
return baseExperience
}
if (override.type === 'native') {
return {
type: 'native',
url: null,
bridge: 'content-v1',
fallback: 'native',
}
}
if (override.type === 'h5' && override.url) {
return {
type: 'h5',
url: override.url,
bridge: override.bridge || (baseExperience ? baseExperience.bridge : 'content-v1'),
fallback: override.fallback || 'native',
}
}
return baseExperience
}
function applyDisplayContentOverride(
baseContent: GameControlDisplayContent,
override: GameControlDisplayContentOverride | undefined,
@@ -33,6 +64,10 @@ function applyDisplayContentOverride(
autoPopup: override.autoPopup !== undefined ? override.autoPopup : baseContent.autoPopup,
once: override.once !== undefined ? override.once : baseContent.once,
priority: override.priority !== undefined ? override.priority : baseContent.priority,
clickTitle: override.clickTitle !== undefined ? override.clickTitle : baseContent.clickTitle,
clickBody: override.clickBody !== undefined ? override.clickBody : baseContent.clickBody,
contentExperience: applyExperienceOverride(baseContent.contentExperience, override.contentExperience),
clickExperience: applyExperienceOverride(baseContent.clickExperience, override.clickExperience),
}
}
@@ -70,6 +105,10 @@ export function buildGameDefinitionFromCourse(
autoPopup: true,
once: false,
priority: 1,
clickTitle: '比赛开始',
clickBody: `${start.label || '开始点'}已激活，按提示前往下一个目标点。`,
contentExperience: null,
clickExperience: null,
}, controlContentOverrides[startId]),
})
}
@@ -94,6 +133,10 @@ export function buildGameDefinitionFromCourse(
autoPopup: true,
once: false,
priority: 1,
clickTitle: score !== null ? `收集 ${label} (+${score}分)` : `收集 ${label}`,
clickBody: score !== null ? `${buildDisplayBody(label, control.sequence)} · ${score}分` : buildDisplayBody(label, control.sequence),
contentExperience: null,
clickExperience: null,
}, controlContentOverrides[controlId]),
})
}
@@ -116,6 +159,10 @@ export function buildGameDefinitionFromCourse(
autoPopup: true,
once: false,
priority: 2,
clickTitle: '完成路线',
clickBody: `${finish.label || '结束点'}已完成，准备查看本局结果。`,
contentExperience: null,
clickExperience: null,
}, controlContentOverrides[finishId] || controlContentOverrides[legacyFinishId]),
})
}

22
miniprogram/game/core/gameDefinition.ts
View File

@@ -5,12 +5,30 @@ export type GameMode = 'classic-sequential' | 'score-o'
export type GameControlKind = 'start' | 'control' | 'finish'
export type PunchPolicyType = 'enter' | 'enter-confirm'
export interface GameContentExperienceConfig {
type: 'native' | 'h5'
url: string | null
bridge: string
fallback: 'native'
}
export interface GameContentExperienceConfigOverride {
type?: 'native' | 'h5'
url?: string
bridge?: string
fallback?: 'native'
}
export interface GameControlDisplayContent {
title: string
body: string
autoPopup: boolean
once: boolean
priority: number
clickTitle: string | null
clickBody: string | null
contentExperience: GameContentExperienceConfig | null
clickExperience: GameContentExperienceConfig | null
}
export interface GameControlDisplayContentOverride {
@@ -19,6 +37,10 @@ export interface GameControlDisplayContentOverride {
autoPopup?: boolean
once?: boolean
priority?: number
clickTitle?: string
clickBody?: string
contentExperience?: GameContentExperienceConfigOverride
clickExperience?: GameContentExperienceConfigOverride
}
export interface GameControl {

26
miniprogram/game/experience/h5Experience.ts Normal file
View File

@@ -0,0 +1,26 @@
export type H5ExperienceKind = 'content' | 'result'
export interface H5ExperienceFallbackPayload {
title: string
body: string
motionClass: string
contentKey: string
once: boolean
priority: number
autoPopup: boolean
}
export interface H5ExperienceRequest {
kind: H5ExperienceKind
title: string
url: string
bridgeVersion: string
context: Record<string, unknown>
fallback: H5ExperienceFallbackPayload
}
export interface H5BridgeMessage {
action?: string
type?: string
payload?: Record<string, unknown>
}

13
miniprogram/game/rules/classicSequentialRule.ts
View File

@@ -279,7 +279,10 @@ function getInitialTargetId(definition: GameDefinition): string | null {
return firstTarget ? firstTarget.id : null
}
function buildCompletedEffect(control: GameControl): GameEffect {
function buildCompletedEffect(control: GameControl, punchPolicy: GameDefinition['punchPolicy']): GameEffect {
const allowAutoPopup = punchPolicy === 'enter'
? false
: (control.displayContent ? control.displayContent.autoPopup : true)
if (control.kind === 'start') {
return {
type: 'control_completed',
@@ -289,7 +292,7 @@ function buildCompletedEffect(control: GameControl): GameEffect {
label: control.label,
displayTitle: control.displayContent ? control.displayContent.title : '比赛开始',
displayBody: control.displayContent ? control.displayContent.body : '已完成开始点打卡，前往 1 号点。',
displayAutoPopup: control.displayContent ? control.displayContent.autoPopup : true,
displayAutoPopup: allowAutoPopup,
displayOnce: control.displayContent ? control.displayContent.once : false,
displayPriority: control.displayContent ? control.displayContent.priority : 1,
}
@@ -304,7 +307,7 @@ function buildCompletedEffect(control: GameControl): GameEffect {
label: control.label,
displayTitle: control.displayContent ? control.displayContent.title : '比赛结束',
displayBody: control.displayContent ? control.displayContent.body : '已完成终点打卡，本局结束。',
displayAutoPopup: control.displayContent ? control.displayContent.autoPopup : true,
displayAutoPopup: allowAutoPopup,
displayOnce: control.displayContent ? control.displayContent.once : false,
displayPriority: control.displayContent ? control.displayContent.priority : 2,
}
@@ -322,7 +325,7 @@ function buildCompletedEffect(control: GameControl): GameEffect {
label: control.label,
displayTitle,
displayBody,
displayAutoPopup: control.displayContent ? control.displayContent.autoPopup : true,
displayAutoPopup: allowAutoPopup,
displayOnce: control.displayContent ? control.displayContent.once : false,
displayPriority: control.displayContent ? control.displayContent.priority : 1,
}
@@ -353,7 +356,7 @@ function applyCompletion(definition: GameDefinition, state: GameSessionState, cu
phase: resolveClassicPhase(nextTarget, currentTarget, finished),
},
}
const effects: GameEffect[] = [buildCompletedEffect(currentTarget)]
const effects: GameEffect[] = [buildCompletedEffect(currentTarget, definition.punchPolicy)]
if (finished) {
effects.push({ type: 'session_finished' })

13
miniprogram/game/rules/scoreORule.ts
View File

@@ -241,7 +241,10 @@ function buildPunchHintText(
: `进入${targetLabel}后点击打点`
}
function buildCompletedEffect(control: GameControl): GameEffect {
function buildCompletedEffect(control: GameControl, punchPolicy: GameDefinition['punchPolicy']): GameEffect {
const allowAutoPopup = punchPolicy === 'enter'
? false
: (control.displayContent ? control.displayContent.autoPopup : true)
if (control.kind === 'start') {
return {
type: 'control_completed',
@@ -251,7 +254,7 @@ function buildCompletedEffect(control: GameControl): GameEffect {
label: control.label,
displayTitle: control.displayContent ? control.displayContent.title : '比赛开始',
displayBody: control.displayContent ? control.displayContent.body : '已完成开始点打卡，开始自由打点。',
displayAutoPopup: control.displayContent ? control.displayContent.autoPopup : true,
displayAutoPopup: allowAutoPopup,
displayOnce: control.displayContent ? control.displayContent.once : false,
displayPriority: control.displayContent ? control.displayContent.priority : 1,
}
@@ -266,7 +269,7 @@ function buildCompletedEffect(control: GameControl): GameEffect {
label: control.label,
displayTitle: control.displayContent ? control.displayContent.title : '比赛结束',
displayBody: control.displayContent ? control.displayContent.body : '已完成终点打卡，本局结束。',
displayAutoPopup: control.displayContent ? control.displayContent.autoPopup : true,
displayAutoPopup: allowAutoPopup,
displayOnce: control.displayContent ? control.displayContent.once : false,
displayPriority: control.displayContent ? control.displayContent.priority : 2,
}
@@ -281,7 +284,7 @@ function buildCompletedEffect(control: GameControl): GameEffect {
label: control.label,
displayTitle: control.displayContent ? control.displayContent.title : `收集 ${sequenceText}`,
displayBody: control.displayContent ? control.displayContent.body : control.label,
displayAutoPopup: control.displayContent ? control.displayContent.autoPopup : true,
displayAutoPopup: allowAutoPopup,
displayOnce: control.displayContent ? control.displayContent.once : false,
displayPriority: control.displayContent ? control.displayContent.priority : 1,
}
@@ -435,7 +438,7 @@ function applyCompletion(
currentTargetControlId: nextPrimaryTarget ? nextPrimaryTarget.id : null,
}, nextModeState)
const effects: GameEffect[] = [buildCompletedEffect(control)]
const effects: GameEffect[] = [buildCompletedEffect(control, definition.punchPolicy)]
if (control.kind === 'finish') {
effects.push({ type: 'session_finished' })
}