本文挑了一款「愛消除」風格的網頁小遊戲當作分析對象,藉它把 Mugeda API 的實際用法走一遍,也順便示範怎麼把 Mugeda 動畫當成遊戲開發的骨架來使用。
只要三顆同色石頭在橫列或直行上彼此相鄰,它們就會消失,上方的石頭隨之落下補位。

遊戲啟動時先建立一個 8×8、共 64 格的石頭矩陣,石頭由上往下依序落入,並全部登記在同一個陣列中統一管理,每顆石頭都帶有自己的類型編號。
接著為石頭物件掛上 inputstart 與 inputend 兩個事件監聽器,就能同時支援「點擊兩下交換」與「拖曳交換」兩種操作手感。玩家完成一次有效輸入後,程式先把相鄰的兩顆石頭互換,再跑一次消除判定;如果換完湊不出任何可消除的組合,就自動換回原位。
遊戲運行期間,每一幀都會呼叫一次 runcheck():先沿著列掃過整個陣列,找出連續三個以上同類型的石頭,再沿著行掃一遍。一旦命中,就消除這些石頭、補上新生石頭,並讓它們由上而下依序墜入空位。
Game.createStone = function (type, index, posY) {
var j = Math.floor(index / hang);
var i = num - hang * j;
var instance = mugeda.createInstanceOfSymbol('stone' + type);
scene.appendChild(instance, null);
instance.left = kuan * i;
instance.top = posY;
instance.addEventListener("inputstart", onStart); // 監聽 inputstart
instance.addEventListener("inputend", onClick); // 監聽 inputend
instance.scene.setSegment("static", 0, 0, false); // 靜態 segment
instance.scene.setSegment("run", 1, 10, true); // 消失特效的動態 segment
instance.scene.playSegment("static");
return instance;
};
三個參數的含義:
石頭建好之後,別忘了把它登記進陣列:
var instance = Game.createStone(type, (j * hang + i), posY);
stoneArray.push({ obj: instance, type: type, v: v0 });
把石頭從舞台上摘除,同時清空它在陣列中的物件引用與類型標記:
scene.removeChild(stoneArray[xiaoArray[x].num].obj); stoneArray[xiaoArray[x].num].obj = null; stoneArray[xiaoArray[x].num].type = 0;
var type = Math.floor(Math.random() * 100) % 6; var instance = game.createStone(type, (i - x * hang), posY); stoneArray[i - x * hang].type = type; stoneArray[i - x * hang].obj = instance;
從一個規則單純的小遊戲下手,是熟悉 Mugeda API 最有效率的路。更具體的 API 介面說明,可以參考《Mugeda HTML5 技術教程》系列中的「Mugeda API 簡介」一文。至於遊戲邏輯該怎麼安排,可說是見仁見智,這裡就不逐一討論了;唯一想強調的建議是「先易後難」——把最簡單的版本做透、把 API 用法摸熟,再去挑戰更複雜的玩法。下一節,我們要動手做一份能在行動裝置上閱讀的教學課件。