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

miniprogram/game/content/courseToGameDefinition.ts

@@ -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]),
     })
   }