【引言】
“三杯猜球”是一个经典的益智游戏，通常由一名表演者和多名参与者共同完成。表演者会将一个小球放在一个杯子下面，然后将三个杯子快速地交换位置，参与者则需要猜出最终哪个杯子下面有小球。本文将介绍如何使用HarmonyOS NEXT技术，如装饰器、状态管理和动画，来实现一个“三杯猜球”游戏。
【实现目标】
创建一个交互式的游戏，让玩家能够：
1. 开始游戏：通过点击“开始游戏”按钮启动游戏，触发杯子间的随机交换。
2. 调整动画速度：允许用户通过界面上的控制器来调整游戏过程中杯子交换的速度。
3. 调整混合次数：让用户可以设置每局游戏中杯子的混合次数。
4. 显示杯子内容：当动画停止后，玩家可以通过点击任意一个杯子来查看其下面是否有小球。
5. 自动重置：如果所有预定的交换次数完成，游戏会自动重置，等待下一轮开始。
【开发逻辑】
1. 定义杯子类：创建 Cup 类，定义杯子的属性和构造函数。
2. 实现游戏逻辑：
• 初始化游戏状态。
• 实现 startGame() 方法，用于开始游戏。
• 实现 moveCups() 方法，用于移动杯子。
• 实现 swapBalls() 方法，用于交换杯子内的球。
• 实现 resetCupPosition() 方法，用于重置杯子的位置。
3. 动画效果：使用动画库（animateToImmediately）实现杯子的动画效果。
【完整代码】
// 使用装饰器来追踪对象的变化
@ObservedV2
class Cup {// 使用装饰器来追踪属性的变化@Trace positionX: number; // 杯子的X轴位置@Trace positionY: number; // 杯子的Y轴位置@Trace containsBall: boolean; // 杯子内是否有球@Trace isRevealed: boolean; // 杯子是否打开// 构造函数初始化杯子的状态constructor(hasBall: boolean) {this.positionX = 0;this.positionY = 0;this.containsBall = hasBall;this.isRevealed = true;}
}// 游戏入口组件
@Entry
@Component
struct ThreeCupGame {// 游戏状态变量@State gameCups: Cup[] = [// 初始化三个杯子，其中一个有球new Cup(true),new Cup(false),new Cup(false)];@State cupWidth: number = 200; // 杯子宽度@State cupSpacing: number = 10; // 杯子之间的间距@State animationDurationMs: number = 140; // 动画持续时间（毫秒）@State isGameAnimating: boolean = false; // 是否正在动画中@State mixingCount: number = 5; // 每局游戏混合次数@State currentMixingCount: number = 0; // 当前正在进行的混合次数计数// 开始游戏的方法startGame() {this.currentMixingCount--; // 减少混合次数const cupPairs = [[0, 1], [0, 2], [1, 2]]; // 可能的杯子对组合const selectedPair = cupPairs[Math.floor(Math.random() * cupPairs.length)]; // 随机选择一对this.moveCups(selectedPair[0], selectedPair[1]); // 开始移动选定的两个杯子}// 移动指定的两个杯子moveCups(cupIndex1: number, cupIndex2: number) {const direction: number = Math.random() < 0.5 ? -1 : 1; // 随机方向const distanceFactor: number = Math.abs(cupIndex1 - cupIndex2); // 距离因子const adjustedDistanceFactor: number = distanceFactor === 1 ? 2 : 1; // 根据距离调整因子animateToImmediately({delay: 0,duration: this.animationDurationMs}, () => {this.gameCups[cupIndex1].positionY = -direction * (this.cupWidth + this.cupSpacing * 2) / adjustedDistanceFactor})animateToImmediately({delay: this.animationDurationMs,duration: this.animationDurationMs}, () => {this.gameCups[cupIndex1].positionX = (this.cupWidth + this.cupSpacing * 2) * distanceFactorthis.gameCups[cupIndex1].positionY = -direction * (this.cupWidth + this.cupSpacing * 2) / adjustedDistanceFactor})animateToImmediately({delay: this.animationDurationMs * 2,duration: this.animationDurationMs}, () => {this.gameCups[cupIndex1].positionX = (this.cupWidth + this.cupSpacing * 2) * distanceFactorthis.gameCups[cupIndex1].positionY = 0})animateToImmediately({delay: 0,duration: this.animationDurationMs}, () => {this.gameCups[cupIndex2].positionY = direction * (this.cupWidth + this.cupSpacing * 2) / adjustedDistanceFactor})animateToImmediately({delay: this.animationDurationMs,duration: this.animationDurationMs}, () => {this.gameCups[cupIndex2].positionX = -(this.cupWidth + this.cupSpacing * 2) * distanceFactorthis.gameCups[cupIndex2].positionY = direction * (this.cupWidth + this.cupSpacing * 2) / adjustedDistanceFactor})animateToImmediately({delay: this.animationDurationMs * 2,duration: this.animationDurationMs,onFinish: () => {this.swapBalls(cupIndex1, cupIndex2)}}, () => {this.gameCups[cupIndex2].positionX = -(this.cupWidth + this.cupSpacing * 2) * distanceFactorthis.gameCups[cupIndex2].positionY = 0})}// 重置杯子的位置resetCupPosition(cupIndex: number) {this.gameCups[cupIndex].positionX = 0;this.gameCups[cupIndex].positionY = 0;}// 交换两个杯子内的球swapBalls(cupIndex1: number, cupIndex2: number) {this.resetCupPosition(cupIndex1);this.resetCupPosition(cupIndex2);let temporaryBallStatus = this.gameCups[cupIndex1].containsBall;this.gameCups[cupIndex1].containsBall = this.gameCups[cupIndex2].containsBall;this.gameCups[cupIndex2].containsBall = temporaryBallStatus;if (this.currentMixingCount <= 0) {this.isGameAnimating = false;} else {setTimeout(() => {this.startGame();}, 10);}}// 构建游戏界面build() {Column({ space: 20 }) {// 游戏标题Text('猜小球游戏').fontSize(24).margin({ top: 20 });// 动画速度控制器Counter() {Text(`当前速度${this.animationDurationMs}毫秒`).fontColor(Color.Black).fontSize('26lpx');}.width('400lpx').onInc(() => {this.animationDurationMs += 10;}).onDec(() => {this.animationDurationMs -= 10;this.animationDurationMs = this.animationDurationMs < 10 ? 10 : this.animationDurationMs;});// 混合次数控制器Counter() {Text(`每局混合${this.mixingCount}次`).fontColor(Color.Black).fontSize('26lpx');}.width('400lpx').onInc(() => {this.mixingCount += 1;}).onDec(() => {this.mixingCount -= 1;this.mixingCount = this.mixingCount < 1 ? 1 : this.mixingCount});// 杯子布局Row() {ForEach(this.gameCups, (cup: Cup) => {Text(cup.isRevealed ? (cup.containsBall ? '小球' : '空') : '').width(`${this.cupWidth}lpx`).height(`${this.cupWidth}lpx`).margin(`${this.cupSpacing}lpx`).backgroundColor(Color.Orange).fontSize(`${this.cupWidth / 4}lpx`).textAlign(TextAlign.Center).fontColor(Color.White).borderRadius(5).translate({ x: `${cup.positionX}lpx`, y: `${cup.positionY}lpx` }).onClick(() => {if (!this.isGameAnimating) {cup.isRevealed = true;}});});}.justifyContent(FlexAlign.Center).width('100%').height('720lpx').backgroundColor(Color.Gray);// 开始游戏按钮Button('开始游戏').onClick(() => {if (!this.isGameAnimating) {this.currentMixingCount = this.mixingCount;this.isGameAnimating = true;this.gameCups.forEach(cup => cup.isRevealed = false);this.startGame();}});}.width('100%').height('100%');}
}
