读源码系列(swift2048)-controller篇

前言

笔者是swift自学新手,希望借助阅读别人开源项目提升自己swift水平。文中尽量使用文字说明来代替代码的堆砌,建议对着源码阅读,以便更好理解项目。文中难免有错误之处,欢迎各路大牛留言指正。

项目信息

swift-2048 github地址


项目主界面

该项目可以说一个带有实验学习性质的项目,其中部分功能没有实现或不完整。但2048游戏的基本功能均完整实现。笔者将分3篇文章,分别按controller、model、view的进行介绍。

本篇是第1篇,将重点展开介绍controller部分。

开始

对于一个完整项目,笔者喜欢从AppDelegate读起:

1.AppDelegate没有添加代码;

2.Main.storyboard中只有一个startGame按钮;

3.开始按钮对应的方法也内也只有2句代码:

@IBAction func startGameButtonTapped(sender : UIButton) {

    let game = NumberTileGameViewController(dimension: 4, threshold: 2048)

    self.presentViewController(game, animated: true, completion: nil)

}

可见游戏的所有功能业务逻辑应该全部在NumberTileGameViewController中。

补充解释

dimension 表示游戏盘的维度,dimension=4表示4*4大小的游戏盘。

threshold 表示游戏胜利条件,threshold=2048表示当出现2048时游戏结束。

正题

NumberTileGameViewController是整个游戏的的入口。不说大家应该也猜到了,本类里面的内容就是model+view。

//model:

var model: GameModel? //整个游戏的model

//view:

var board: GameboardView? //游戏盘的view

var scoreView: ScoreViewProtocol? //显示等分的view

contoller如何使用model?


全文中“游戏盘”“棋子”的含义


model在init中初始化:

model = GameModel(dimension: dimension, threshold: threshold, delegate: self)

model有主要4个方法被controller主动调用:

m.insertTileAtRandomLocation(2) 在游戏盘上一个随机位置插入一枚棋子

m.userHasWon() 判断是否是获胜

m.userHasLost() 判断是否是失败

m.queueMove(MoveDirection.Down, completion: { ... })//移动棋子(向下滑动手势)

上面4个方法,主要是在用户滑动手势之后进行调用,滑动手势对应的方法中主要完成以下3步:

1》queueMove移动格子

2》移动完成后,判断是否获胜userHasWon或失败userHasLost

3》如果游戏可以继续,插入新格子insertTileAtRandomLocation

可见,上面是典型的 view(手势)更新 model 的流程。

model通知view,也使用了典型的做法--委托

model定义了如下协议:

protocol GameModelProtocol : class {

    func scoreChanged(score: Int)

    func moveOneTile(from: (Int, Int), to: (Int, Int), value: Int)

    func moveTwoTiles(from: ((Int, Int), (Int, Int)), to: (Int, Int), value: Int)

    func insertTile(location: (Int, Int), value: Int)

}

本协议定义了游戏model所产生的结果动作:

1》scoreChanged 得分变化

2》moveOneTile 移动一个棋子,到一个新位置

3》moveTwoTiles 移动2个棋子,到一个新位置

4》insertTile 插入新棋子

其中,1、4还是很好理解。2、3 是开发者根据游戏的特点所抽象出的2种棋子移动方式(具体说明将在专门分析model时提到)。这四个方法均在NumberTileGameViewController中实现。实现很简单,即直接调用相应view的方法:1调用的是scoreView的scoreChange;2.3.4调用是board(GameBoardVIew)的moveOneTile、moveTwoTiles、insertTile方法。例如:

func insertTile(location: (Int, Int), value: Int) {//插入新棋子的协议实现

    assert(board != nil)

    let b = board!

    b.insertTile(location, value: value)//调用view对应的方法

}


梳理controller主要方法的流程

init方法:

1.创建GameModel

2.setupSwipeControls 创建滑动手势的动作

viewDidLoad方法:

调用setupGame, 安装Game相关的view (后面有本函数的流程说明)

滑动手势的处理方法:

func downCommand(r: UIGestureRecognizer!) {

    assert(model != nil)

    let m = model!

    m.queueMove(MoveDirection.Down, //调用model,进行业务处理

    completion: { (changed: Bool) -> () in //本无名闭包将在model调用委托方法之后,执行

        if changed {

            self.followUp() //这个是后续方法,执行如判断游戏胜利失败或插入新棋子)

        }

   })

}

setupGame方法:

1创建内部函数xPositionToCenterView。返回一个view水平居中后的x

2内部函数yPositionForViewAtPosition 给一组view垂直居中后,其中某一个view的y

3创建scoreView

4创建game board view

5通过前面的内部函数,计算出scoreView和gameBoardView的frame中的xy

6将scoreView和game board加入主view,并赋值到viewcontrller的对应属性

7调用model,新增随机游戏棋子,开始游戏

总结

本项目中的viewcontroller的职能很清晰的,主要是下面2点:

1》初始化view、model、手势

2》协助view和model交互(手势处理函数中调用model;model的委托函数中调用view)

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 195,783评论 5 462
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 82,360评论 2 373
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 142,942评论 0 325
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,507评论 1 267
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,324评论 5 358
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,299评论 1 273
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,685评论 3 386
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,358评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,652评论 1 293
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,704评论 2 312
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,465评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,318评论 3 313
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,711评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,991评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,265评论 1 251
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,661评论 2 342
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,864评论 2 335

推荐阅读更多精彩内容