> For the complete documentation index, see [llms.txt](https://sharinghub.kittenbot.hk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sharinghub.kittenbot.hk/wifibrick_iot/wifibrick_makecode/wifibrick-yu-koi-1/makercloud.md).

# Makecode 編程與MakerCloud

![](https://kittenbothk.readthedocs.io/en/latest/_images/mcbanner8.png)

### MakerCloud官方教學

MakerCloud有提供官方的教學，此頁面僅為KittenBot HK提供的教學，一切以官方教學為準。

[Microbit x WiFiBrick教學](https://learn.makercloud.io/zh_TW/latest/ch4_connect/microbit/connect_microbit/)

[Microbit x KOI教學](https://learn.makercloud.io/zh_TW/latest/ch4_connect/KOI/connect_KOI/)

### 前言：

在這節教程，我們將會學習使用WifiBrick在MakerCloud上如何發布資料和接收資料。

我們會使用Robotbit作範例。

```
KOI也支援Makercloud。
```

### 硬件準備

在編程前請確保硬件及接線沒有問題。

[硬件接線方法](/wifibrick_iot/wifibrick/wifibrick_intro.md#jie-xian-fang-fa)

### 第一步：平台準備

我們首先要登入MakerCloud平台，設立好MQTT主題。

[前往MakerCloud](https://www.makercloud.io/user/login?ref=/)

登入之後前往主頁，點擊『創建項目』。

```
你亦可以使用你先前創立的項目。
```

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc16.png)

剔選物聯網項目，輸入項目名稱，並點擊『創建項目』。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc27.png)

之後我們就可以創建自己的主題。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc32.png)

創建之後，我們會在頁面看到我們剛剛創下的頁面，並且寫有主題名稱。

這個主題名稱是你的私密資料，請不要讓其他人得知。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc42.png)

去到這裡，MQTT主題的設立就大功告成了，然後我們就可以開始進行編程。

### 第二步：加載插件

我們要先加載MakerCloud的插件，這樣才可以與MakerCloud的伺服器連接。

wifibrick插件地址：<https://github.com/maxwong-scale/pxt-makercloud-V2>

koi插件地址：<https://github.com/scaleinnotech/pxt-makercloud-koi>

#### [詳細方法](/programmingplatforms/makecode/kittenbotandmakecode.md)

### 第三步：編程

#### 1：將WifiBrick連上網絡並連接創客雲伺服器。

連接積木塊：

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc121.png)

首先更新引腳初始化WifiBrick，然後連接Wifi網絡，再連上伺服器。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc51.png)

假如你使用Armourbit，只要將更新引腳的積木改為Armourbit的積木就可以了。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc61.png)

連接網絡的時候Microbit會顯示以下動畫。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc16.gif)

連接創客雲MQTT時會顯示以下動畫。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc17.gif)

#### 2：發佈到MQTT主題。

發佈積木塊：

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc131.png)

我們會發佈一個隨機數字到我們剛剛設立的主題。

將之前設立的主題名稱複製並貼上。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc71.png)

成功發佈之後，資料會顯示在項目的即時數據紀錄中。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc101.png)

數據亦會自動產生一個圖表。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc151.png)

同時，我們亦可以手動在主題中發送訊息。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc112.png)

#### 3：訂閱MQTT主題。

訂閱積木塊：

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc141.png)

要讀取MQTT主題上的資料，我們一定要訂閱該主題。

以下，我們會訂閱剛才設立了的主題，讀取我們發佈的資料。

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc81.png)

### 參考程式

#### Wifibrick參考程式

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc91.png)

[參考程式下載](https://makecode.microbit.org/_KiMFEa7Kv4p1)

#### KOI參考程式

![](https://kittenbothk.readthedocs.io/en/latest/_images/mc181.png)

[參考程式下載](https://makecode.microbit.org/_3ue0j0gjbaRY)

### 總結：

看到這裡，相信大家都大概熟悉在WifiBrick使用創客雲的方法吧。其實創客雲還有創建圖表，資料觸發等的功能，所以說大家用創客雲不需要只是局限於MQTT上呢！

### 插件版本與更新

插件可能會不定時推出更新，改進功能。亦有時候我們可能需要轉用舊版插件才可使用某些功能。

詳情請參考: [Makecode插件版本更換](/programmingplatforms/makecode/makecodeextupdate.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://sharinghub.kittenbot.hk/wifibrick_iot/wifibrick_makecode/wifibrick-yu-koi-1/makercloud.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.