HarmonyOS開發(fā)案例：【抽獎轉(zhuǎn)盤】

介紹

本篇Codelab是基于畫布組件、顯式動畫，實現(xiàn)的一個自定義抽獎圓形轉(zhuǎn)盤。包含如下功能：

1. 通過畫布組件Canvas，畫出抽獎圓形轉(zhuǎn)盤。
2. 通過顯式動畫啟動抽獎功能。
3. 通過自定義彈窗彈出抽中的獎品。

相關(guān)概念

• [Stack組件]：堆疊容器，子組件按照順序依次入棧，后一個子組件覆蓋前一個子組件。
• [Canvas]：畫布組件，用于自定義繪制圖形。
• [CanvasRenderingContext2D對象]：使用RenderingContext在Canvas組件上進行繪制，繪制對象可以是矩形、文本、圖片等。
• [顯式動畫]：提供全局animateTo顯式動畫接口來指定由于閉包代碼導(dǎo)致的狀態(tài)變化插入過渡動效。
• [自定義彈窗]： 通過CustomDialogController類顯示自定義彈窗。

環(huán)境搭建

軟件要求

• [DevEco Studio]版本：DevEco Studio 3.1 Release。
• OpenHarmony SDK版本：API version 9。

硬件要求

• 開發(fā)板類型：[潤和RK3568開發(fā)板]。
• OpenHarmony系統(tǒng)：3.2 Release。

環(huán)境搭建

完成本篇Codelab我們首先要完成開發(fā)環(huán)境的搭建，本示例以RK3568開發(fā)板為例，參照以下步驟進行：

1. [獲取OpenHarmony系統(tǒng)版本]：標(biāo)準(zhǔn)系統(tǒng)解決方案（二進制）。以3.2 Release版本為例：
   
2. 搭建燒錄環(huán)境。
   1. [完成DevEco Device Tool的安裝]
   2. [完成RK3568開發(fā)板的燒錄]
3. 搭建開發(fā)環(huán)境。
   1. 開始前請參考[工具準(zhǔn)備]，完成DevEco Studio的安裝和開發(fā)環(huán)境配置。
   2. 開發(fā)環(huán)境配置完成后，請參考[使用工程向?qū)創(chuàng)建工程（模板選擇“Empty Ability”）。
   3. 工程創(chuàng)建完成后，選擇使用[真機進行調(diào)測]。
   4. 鴻蒙開發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

代碼結(jié)構(gòu)解讀

本篇Codelab只對核心代碼進行講解，對于完整代碼，我們會在gitee中提供。

├──entry/src/main/ets	            // 代碼區(qū)
│  ├──common
│  │  ├──constants
│  │  │  ├──ColorConstants.ets      // 顏色常量類
│  │  │  ├──CommonConstants.ets     // 公共常量類 
│  │  │  └──StyleConstants.ets      // 樣式常量類 
│  │  └──utils
│  │     ├──CheckEmptyUtils.ets     // 數(shù)據(jù)判空工具類
│  │     └──Logger.ets              // 日志打印類
│  ├──entryability
│  │  └──EntryAbility.ts            // 程序入口類
│  ├──pages
│  │  └──CanvasPage.ets             // 主界面	
│  ├──view
│  │  └──PrizeDialog.ets            // 中獎信息彈窗類
│  └──viewmodel
│     ├──DrawModel.ets              // 畫布相關(guān)方法類
│     ├──FillArcData.ets            // 繪制圓弧數(shù)據(jù)實體類
│     └──PrizeData.ets              // 中獎信息實體類
└──entry/src/main/resources         // 資源文件目錄

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

構(gòu)建主界面

在這個章節(jié)中，我們將完成示例主界面的開發(fā)，效果如圖所示：

在繪制抽獎圓形轉(zhuǎn)盤前，首先需要在CanvasPage.ets的aboutToAppear()方法中獲取屏幕的寬高。

// CanvasPage.ets
// 獲取context
let context = getContext(this);

aboutToAppear() {
  // 獲取屏幕的寬高
  window.getLastWindow(context)
    .then((windowClass) = > {
      let windowProperties = windowClass.getWindowProperties();
      this.screenWidth = px2vp(windowProperties.windowRect.width);
      this.screenHeight = px2vp(windowProperties.windowRect.height);
    })
    .catch((error: Error) = > {
      Logger.error('Failed to obtain the window size. Cause: ' + JSON.stringify(error));
    })
}

在CanvasPage.ets布局界面中添加Canvas組件，在onReady()方法中進行繪制。

// CanvasPage.ets
private settings: RenderingContextSettings = new RenderingContextSettings(true);
private canvasContext: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings);

Stack({ alignContent: Alignment.Center }) {
  Canvas(this.canvasContext)
    ...
    .onReady(() = > {
      // 通過draw方法進行繪制
      this.drawModel.draw(this.canvasContext, this.screenWidth, this.screenHeight);
    })

  // 開始抽獎圖片
  Image($r('app.media.ic_center'))
    ...
}
...

在DrawModel.ets中，通過draw()方法逐步進行自定義圓形抽獎轉(zhuǎn)盤的繪制。

// DrawModel.ets
// 畫抽獎圓形轉(zhuǎn)盤
draw(canvasContext: CanvasRenderingContext2D, screenWidth: number, screenHeight: number) {
  if (CheckEmptyUtils.isEmptyObj(canvasContext)) {
    Logger.error('[DrawModel][draw] canvasContext is empty.');
    return;
  }
  this.canvasContext= canvasContext;
  this.screenWidth = screenWidth;
  this.canvasContext.clearRect(0, 0, this.screenWidth, screenHeight);
  // 將畫布沿X、Y軸平移指定距離
  this.canvasContext.translate(this.screenWidth / CommonConstants.TWO,
    screenHeight / CommonConstants.TWO);
  // 畫外部圓盤的花瓣
  this.drawFlower();
  // 畫外部圓盤、小圈圈
  this.drawOutCircle();
  // 畫內(nèi)部圓盤
  this.drawInnerCircle();
  // 畫內(nèi)部扇形抽獎區(qū)域
  this.drawInnerArc();
  // 畫內(nèi)部扇形區(qū)域文字
  this.drawArcText();
  // 畫內(nèi)部扇形區(qū)域獎品對應(yīng)的圖片
  this.drawImage();
  this.canvasContext.translate(-this.screenWidth / CommonConstants.TWO,
    -screenHeight / CommonConstants.TWO);
}

畫外部圓盤

畫外部圓盤的花瓣：通過調(diào)用rotate()方法，將畫布旋轉(zhuǎn)指定角度。再通過調(diào)用save()和restore()方法，使畫布保存最新的繪制狀態(tài)。根據(jù)想要繪制的花瓣個數(shù)，改變旋轉(zhuǎn)角度，循環(huán)畫出花瓣效果。

// DrawModel.ets
// 畫外部圓盤的花瓣
drawFlower() {
  let beginAngle = this.startAngle + this.avgAngle;
  const pointY = this.screenWidth * CommonConstants.FLOWER_POINT_Y_RATIOS;
  const radius = this.screenWidth * CommonConstants.FLOWER_RADIUS_RATIOS;
  const innerRadius = this.screenWidth * CommonConstants.FLOWER_INNER_RATIOS;
  for (let i = 0; i < CommonConstants.COUNT; i++) {
    this.canvasContext?.save();
    this.canvasContext?.rotate(beginAngle * Math.PI / CommonConstants.HALF_CIRCLE);
    this.fillArc(new FillArcData(0, -pointY, radius, 0, Math.PI * CommonConstants.TWO),
      ColorConstants.FLOWER_OUT_COLOR);

    this.fillArc(new FillArcData(0, -pointY, innerRadius, 0, Math.PI * CommonConstants.TWO),
      ColorConstants.FLOWER_INNER_COLOR);
    beginAngle += this.avgAngle;
    this.canvasContext?.restore();
  }
}

// 畫弧線方法
fillArc(fillArcData: FillArcData, fillColor: string) {
  if (CheckEmptyUtils.isEmptyObj(fillArcData) || CheckEmptyUtils.isEmptyStr(fillColor)) {
    Logger.error('[DrawModel][fillArc] fillArcData or fillColor is empty.');
    return;
  }
  if (this.canvasContext !== undefined) {
    this.canvasContext.beginPath();
    this.canvasContext.fillStyle = fillColor;
    this.canvasContext.arc(fillArcData.x, fillArcData.y, fillArcData.radius,
      fillArcData.startAngle, fillArcData.endAngle);
    this.canvasContext.fill();
  }
}

畫外部圓盤、圓盤邊上的小圈圈：在指定的X、Y（0, 0）坐標(biāo)處，畫一個半徑為this.screenWidth * CommonConstants.OUT_CIRCLE_RATIOS的圓形。接下來通過一個for循環(huán)，且角度每次遞增CommonConstants.CIRCLE / CommonConstants.SMALL_CIRCLE_COUNT，來繪制圓環(huán)上的小圈圈。

// DrawModel.ets
drawOutCircle() {
  // 畫外部圓盤
  this.fillArc(new FillArcData(0, 0, this.screenWidth * CommonConstants.OUT_CIRCLE_RATIOS, 0,
    Math.PI * CommonConstants.TWO), ColorConstants.OUT_CIRCLE_COLOR);

  let beginAngle = this.startAngle;
  // 畫小圓圈
  for (let i = 0; i < CommonConstants.SMALL_CIRCLE_COUNT; i++) {
    this.canvasContext?.save();
    this.canvasContext?.rotate(beginAngle * Math.PI / CommonConstants.HALF_CIRCLE);
    this.fillArc(new FillArcData(this.screenWidth * CommonConstants.SMALL_CIRCLE_RATIOS, 0,
      CommonConstants.SMALL_CIRCLE_RADIUS, 0, Math.PI * CommonConstants.TWO),
      ColorConstants.WHITE_COLOR);
    beginAngle = beginAngle + CommonConstants.CIRCLE / CommonConstants.SMALL_CIRCLE_COUNT;
    this.canvasContext?.restore();
  }
}

畫內(nèi)部扇形抽獎區(qū)域

畫內(nèi)部圓盤、內(nèi)部扇形抽獎區(qū)域：使用fillArc()方法繪制內(nèi)部圓盤。通過一個for循環(huán)，角度每次遞增this.avgAngle。然后不斷更改弧線的起始弧度this.startAngle * Math.PI / CommonConstants.HALF_CIRCLE和弧線的終止弧度(this.startAngle + this.avgAngle) * Math.PI / CommonConstants.HALF_CIRCLE。最后用fill()方法對路徑進行填充。

// DrawModel.ets
// 畫內(nèi)部圓盤
drawInnerCircle() {
  this.fillArc(new FillArcData(0, 0, this.screenWidth * CommonConstants.INNER_CIRCLE_RATIOS, 0,
    Math.PI * CommonConstants.TWO), ColorConstants.INNER_CIRCLE_COLOR);
  this.fillArc(new FillArcData(0, 0, this.screenWidth * CommonConstants.INNER_WHITE_CIRCLE_RATIOS, 0,
    Math.PI * CommonConstants.TWO), ColorConstants.WHITE_COLOR);
}

// 畫內(nèi)部扇形抽獎區(qū)域
drawInnerArc() {
  // 顏色集合
  let colors = [
    ColorConstants.ARC_PINK_COLOR, ColorConstants.ARC_YELLOW_COLOR,
    ColorConstants.ARC_GREEN_COLOR, ColorConstants.ARC_PINK_COLOR,
    ColorConstants.ARC_YELLOW_COLOR, ColorConstants.ARC_GREEN_COLOR
  ];
  let radius = this.screenWidth * CommonConstants.INNER_ARC_RATIOS;
  for (let i = 0; i < CommonConstants.COUNT; i++) {
    this.fillArc(new FillArcData(0, 0, radius, this.startAngle * Math.PI / CommonConstants.HALF_CIRCLE,
      (this.startAngle + this.avgAngle) * Math.PI / CommonConstants.HALF_CIRCLE), colors[i]);
    this.canvasContext?.lineTo(0, 0);
    this.canvasContext?.fill();
    this.startAngle += this.avgAngle;
  }
}

畫內(nèi)部抽獎區(qū)域文字：用for循環(huán)，通過drawCircularText()方法繪制每組文字。drawCircularText()方法接收三個參數(shù)，分別是字符串，起始弧度和終止弧度。繪制文本前需要設(shè)置每個字母占的弧度angleDecrement，然后設(shè)置水平和垂直的偏移量。垂直偏移量circleText.y - Math.sin(angle) * radius就是朝著圓心移動的距離；水平偏移circleText.x + Math.cos(angle) * radius，是為了讓文字在當(dāng)前弧范圍文字居中。最后使用fillText()方法繪制文本。

// DrawModel.ets
// 畫內(nèi)部扇形區(qū)域文字
drawArcText() {
  if (this.canvasContext !== undefined) {
    this.canvasContext.textAlign = CommonConstants.TEXT_ALIGN;
    this.canvasContext.textBaseline = CommonConstants.TEXT_BASE_LINE;
    this.canvasContext.fillStyle = ColorConstants.TEXT_COLOR;
    this.canvasContext.font = StyleConstants.ARC_TEXT_SIZE + CommonConstants.CANVAS_FONT;
  }
  // 需要繪制的文本數(shù)組集合
  let textArrays = [
    $r('app.string.text_smile'),
    $r('app.string.text_hamburger'),
    $r('app.string.text_cake'),
    $r('app.string.text_smile'),
    $r('app.string.text_beer'),
    $r('app.string.text_watermelon')
  ];
  let arcTextStartAngle = CommonConstants.ARC_START_ANGLE;
  let arcTextEndAngle = CommonConstants.ARC_END_ANGLE;
  for (let i = 0; i < CommonConstants.COUNT; i++) {
    this.drawCircularText(this.getResourceString(textArrays[i]),
      (this.startAngle + arcTextStartAngle) * Math.PI / CommonConstants.HALF_CIRCLE,
      (this.startAngle + arcTextEndAngle) * Math.PI / CommonConstants.HALF_CIRCLE);
    this.startAngle += this.avgAngle;
  }
}

// 繪制圓弧文本
drawCircularText(textString: string, startAngle: number, endAngle: number) {
  if (CheckEmptyUtils.isEmptyStr(textString)) {
    Logger.error('[DrawModel][drawCircularText] textString is empty.');
    return;
  }
  class CircleText {
    x: number = 0;
    y: number = 0;
    radius: number = 0;
  }
  let circleText: CircleText = {
    x: 0,
    y: 0,
    radius: this.screenWidth * CommonConstants.INNER_ARC_RATIOS
  };
  // 圓的半徑
  let radius = circleText.radius - circleText.radius / CommonConstants.COUNT;
  // 每個字母占的弧度
  let angleDecrement = (startAngle - endAngle) / (textString.length - 1);
  let angle = startAngle;
  let index = 0;
  let character: string;

  while (index < textString.length) {
    character = textString.charAt(index);
    this.canvasContext?.save();
    this.canvasContext?.beginPath();
    this.canvasContext?.translate(circleText.x + Math.cos(angle) * radius,
      circleText.y - Math.sin(angle) * radius);
    this.canvasContext?.rotate(Math.PI / CommonConstants.TWO - angle);
    this.canvasContext?.fillText(character, 0, 0);
    angle -= angleDecrement;
    index++;
    this.canvasContext?.restore();
  }
}

畫內(nèi)部抽獎區(qū)域文字對應(yīng)圖片：使用drawImage()方法繪制抽獎區(qū)域文字對應(yīng)圖片，該方法接收五個參數(shù)，分別是圖片資源、繪制區(qū)域左上角的X和Y軸坐標(biāo)、繪制區(qū)域的寬度和高度。

// DrawModel.ets
// 畫內(nèi)部扇形區(qū)域文字對應(yīng)的圖片
drawImage() {
  let beginAngle = this.startAngle;
  let imageSrc = [
    CommonConstants.WATERMELON_IMAGE_URL, CommonConstants.BEER_IMAGE_URL,
    CommonConstants.SMILE_IMAGE_URL, CommonConstants.CAKE_IMAGE_URL,
    CommonConstants.HAMBURG_IMAGE_URL, CommonConstants.SMILE_IMAGE_URL
  ];
  for (let i = 0; i < CommonConstants.COUNT; i++) {
    let image = new ImageBitmap(imageSrc[i]);
    this.canvasContext?.save();
    this.canvasContext?.rotate(beginAngle * Math.PI / CommonConstants.HALF_CIRCLE);
    this.canvasContext?.drawImage(image, this.screenWidth * CommonConstants.IMAGE_DX_RATIOS,
      this.screenWidth * CommonConstants.IMAGE_DY_RATIOS, CommonConstants.IMAGE_SIZE,
      CommonConstants.IMAGE_SIZE);
    beginAngle += this.avgAngle;
    this.canvasContext?.restore();
  }
}

實現(xiàn)抽獎功能

在CanvasPage.ets的Canvas組件中添加rotate屬性，在Image組件中添加點擊事件onClick。點擊“開始抽獎”圖片，圓形轉(zhuǎn)盤開始轉(zhuǎn)動抽獎。

// CanvasPage.ets
Stack({ alignContent: Alignment.Center }) {
  Canvas(this.canvasContext)
    ...
    .onReady(() = > {
      this.drawModel.draw(this.canvasContext, this.screenWidth, this.screenHeight);
    })
    .rotate({
      x: 0,
      y: 0,
      z: 1,
      angle: this.rotateDegree,
      centerX: this.screenWidth / CommonConstants.TWO,
      centerY: this.screenHeight / CommonConstants.TWO
    })

  // 開始抽獎圖片
  Image($r('app.media.ic_center'))
   ...
    .enabled(this.enableFlag)
    .onClick(() = > {
      this.enableFlag = !this.enableFlag;
      // 開始抽獎
      this.startAnimator();
    })
}
...

圓形轉(zhuǎn)盤開始轉(zhuǎn)動抽獎：給轉(zhuǎn)盤指定一個隨機的轉(zhuǎn)動角度randomAngle，保證每次轉(zhuǎn)動的角度是隨機的，即每次抽到的獎品也是隨機的。動畫結(jié)束后，轉(zhuǎn)盤停止轉(zhuǎn)動，抽獎結(jié)束，彈出抽中的獎品信息。

// CanvasPage.ets
dialogController: CustomDialogController = new CustomDialogController({
  builder: PrizeDialog({
    prizeData: $prizeData,
    enableFlag: $enableFlag
  }),
  autoCancel: false
});

// CanvasPage.ets
// 開始抽獎
startAnimator() {
  let randomAngle = Math.round(Math.random() * CommonConstants.CIRCLE);
  // 獲取中獎信息
  this.prizeData = this.drawModel.showPrizeData(randomAngle);

  animateTo({
    duration: CommonConstants.DURATION,
    curve: Curve.Ease,
    delay: 0,
    iterations: 1,
    playMode: PlayMode.Normal,
    onFinish: () = > {
      this.rotateDegree = CommonConstants.ANGLE - randomAngle;
      // 打開自定義彈窗，彈出抽獎信息
      this.dialogController.open();
    }
  }, () = > {
    this.rotateDegree = CommonConstants.CIRCLE * CommonConstants.FIVE +
      CommonConstants.ANGLE - randomAngle;
  })
}

彈出抽中的獎品信息：抽獎結(jié)束后，彈出抽中的文本和圖片信息，通過自定義彈窗實現(xiàn)。

// PrizeDialog.ets
@CustomDialog
export default struct PrizeDialog {
  @Link prizeData: PrizeData;
  @Link enableFlag: boolean;
  private controller?: CustomDialogController;

  build() {
    Column() {
      Image(this.prizeData.imageSrc)
        ...

      Text(this.prizeData.message)
        ...

      Text($r('app.string.text_confirm'))
        ...
        .onClick(() = > {
          // 關(guān)閉自定義彈窗		
          this.controller?.close();
          this.enableFlag = !this.enableFlag;
        })
    }
    ...
  }
}

審核編輯 黃宇