iBeacon 的第一篇（基于Swift实现）

低功耗蓝牙技术现在几乎是智能手机的标配。随着这一技术的发展，苹果在2013年WWDC大会上，苹果推出iBeacon技术。该技术允许开发人员开发能够使用iBeacon硬件传感器的iOS应用程序，来为相应的应用程序提供更加精准的位置信息。2014年WWDC大会上，苹果表示，对iBeacon技术进行了改善，借助该技术，应用程序现在能够跟踪到用户所在的楼层的精确位置信息。

 

iBeacon的工作方式是Transmitter-Receiver，即基站-接收机模式的。基站？这个时候不要想到移动、联通的那些大铁塔。这个基站可以是一个运行着Bluetooth 4.0 LE的设备，也可以是经过配置的iPhone、iPad。iPhone4S和之后的iPhone、iPad3或之后的iPad，包括iPad mini都可以配置成iBeacon基站。

 

这里列举个iBeacon的使用场景：在房屋中介中使用。米国一家技术公司把 iBeacon 安装在要出售的房屋前，当用户开车至此，不用下车就可以用中介的 APP 获得此房屋所有相关信息和照片，不用打印及搜索。据说，效果还是很不错的，大约有一半左右的用户打开手机查看了相关信息。甚至于还有一个老外用iBeacon做了一个实景的经营游戏，点击这里观看。

 

一个基站主要有三部分标识：

 

1. UUID，形如：206A2476-D4DB-42F0-BF73-030236F2C756。用来标识某一个公司。比如，某个房地产公司的全部的基站都用同一个UUID。

2. major，用来标识某一类的beacon。比如这个房地产公司的北京的房子都设定为1，上海的都设定为2。

3. minor，用来标识某一个特定的beacon。比如某栋楼的某个基站。

 

用这个房地产商开发的app就可以获取到UUID，和后面的major值和minor值。当app进入beacon的区域，探测到UUID：”206A2476-D4DB-42F0-BF73-030236F2C756“，major为1，minor为20。那么就表明这个用户在这个房地产商的北京楼盘的编号20的楼盘。这栋楼的说明文字、图片或者视频等就可以展现在用户面前。

 

下面就进入我们的教程。不过前提是你要是苹果的开发者，因为这个app需要在真机运行。然后要有2台设备，一个当基站，一个当接收机。最后，还得有一台能运行Xcode的电脑。

 

首先创建一个SingleView的项目，起个名字叫MyBeacon。然后把我们需要用到的Framework加进来，把CoreBluethooth.framework和CoreLocation.framework加到项目中。

 

创建一个Storybard，并在视图中添加如下的UIController：

 

     (这是Xcode6创建的storyboard)

 

关于storyboard的细节就不多说了。下面新建两个文件：TrackViewController 和 ConfigViewController 。这时候会自动生成一个 ViewControler 类。分别把他们按照上图所示对应到 stroyboard 的几个ViewController 中，并添加图中所示的 UILabel 。然后把需要现实APP运行结果的 UILabel 作为 IBOutlet 。

 

TrackViewController 的 IBOutlet 是这样的：（以下的两个文件都用的是Swift语言，如果你需要的话可以自行修改为OC语言）

 

ConfigViewController 的 IBOutlet 是这样的：

 

先搞定基站部分

 

在 ConfigViewController 中添加如下的属性：

第一个 CLBeaconRegin 属性，用来设置基站需要的 proximityUUID ，major 和 minor 的给你信息。

 

第二个 NSDictionary 的属性，用来获取外设的数据。

 

第三个 CBPeripheralManager 的属性，用来开启基站的数据传输。

 

这些属性后面的感叹号是Swift里的一种语法。变量或者属性的定义，在类型的后面可以是问号后者是感叹号。他们都表示这个变量或者属性可以是有值的也可以是空值nil（注意这里的nil和OC里的nil是两回事）。但是使用问号的变量或者属性需要在使用前判断是否有值，如果有的话通过感叹号取值。使用感叹号定义的变量或者属性则可以直接取值并使用。这里使用感叹号定义属性，这样在使用的时候可以直接取值。详细的使用会在代码中体现。

 

要让iOS设备开始传输信号还需要做些其他的事情。在viewDidLoad中调用几个方法才能让基站工作起来。首先调用的是initBeacon方法，之后是要把数据现实出来的setLabels方法。

 

在这里通过uuid字符串设定NSUUID实例。uuid字符串可以通过uuidgen命令在终端里生成。也可以通过代码生成，但是这里没有这个必要。然后其他的值major和minor分别设定为1，identifier设定为我们示例的名字。

 

下面我们就要考虑传输的问题了。在用户点击了传输按钮之后开始使用设备的蓝牙外设发出信号。方法如下：

 

在这个方法里，首先通过我们设定的beaconRegion属性获得相关的外设数据。这个数据是NSDictionary类型的。需要说明的是，这个类型可以在Swift中使用，但是和Swift本身的Dictionary是不兼容的。

 

之后，初始化了CBPeripheralManager属性。这里简单处理，设定queue和options为nil。为了设定代理为 self 需要实现 CBPeripheralManagerDelegate protocol 。

 

实现了这个protocol之后，还需要实现这个protocol的一个方法。这个方法在OC里来讲是required的，所以必须实现。

外设的状态中有两个需要我们处理的。一个是PoweredOn一个PoweredOff。On了就让peripheralManager开始对外发出信号。Off了就停止发出信号。所以呢，如果直接在transmitAction中调用代码startAdvertising是设备对外发出信号的话，会报错。Console会打印出”CBPeripheralManager is not Powered on“。所以我们在以上的代码中在Pwoered On的时候再开始调用代码发出信号。发出信号的时候呢，我们给了advertising方法传入了从beaconRegion取出来的NSDictionary数据。这也是接收机辨识基站用到的数据。

 

之后我们把数据显示在界面上。

这个方法很简单，只要在viewDidLoad里调用setLabels方法就可以。全部设定在基站里的数据都会显示在界面上了。其中包括uuid、major和minor，最后是我们设定的identifier。用Swift比用OC写代码是会少一些量，如果你对Swift足够熟的话。比如，取得一个值的字符窜值的时候就不用[NSString stringWithFormat:"..."]这么麻烦的写法了。

 

我们的app已经可以作为基站使用了。但是没有接收机的话这个app可是一点都不好玩。在下面就开始处理接收机的部分。

 

接收iBeacon信息

接收iBeacon信号的底层功能已经在Core Location Framework里实现了。在iOS7里，可以自动识别你是否进入了一个区域以及其他的距离之类的信息。

 

下面在TrackViewController中处理，首先把CoreLocation库的头文件加进来。然后增加下面的两个属性：

CLBeaconRegion属性是用来定义我们要寻找的beacon的。这个app只会接收到有同样的UUID的的发射机发射的信号。

 

CLLocationManager属性是用来建立位置服务并搜索beacon的。

 

在viewDidLoad方法中添加如下代码：

首先，要初始化CLLocationManager，然后把代理设置为self。当然设定代理之前我么需要实现CLLocationManagerDelegate protocol，具体的就不写出来了。然后调用initRegion方法，这个会在后面给出详情。

首先创建UUID实例。用来初始化这个实例的的uuid字符串必须和基站的uuid字符串是一样的，要不互相找不见。

 

然后初始化beaconRegion，proximityUUID就是前面创建的UUID实例，identitifer就是在基站中用到的identifier字符串。然后开始监测前面初始化出来的beaconRegion。调用代码self.trackLocationManager.startMonitoringForRegion(self.beaconRegion)开始检测。

 

接下来，我们需要监测这个app进入和离开区域的事件，代码如下：

第一个方法是进入的，当你接收到基站信号的时候这个方法就开始执行（当然你要离基站足够近）。然后调用locationManager的startRagingBeaconsInRegion方法，病传入我们之前定义好的beaconRegion属性。

 

第二个方法很简单，就是在离开这个区域的时候就停止执行，调用locationManager的stopRagingBeaconsInRegion。

 

下面是didRangeBeacons方法：

首先判断方法传入的beacons数组的元素有多少。如果有0个的时候什么都不做。如果有一个或以上的话，这里简单处理只取最后一个beacon来处理。

 

之后的代码都只是从beacon中取出数据来现实在界面上，比如UUID，major，minor，accuracy和RSSI。这些值会随着接收机和基站的距离不同以及基站的设置不同而一直改变。尤其accuracy和RSSI都是beacon用来现实距离的。其中proximity会显示四个值：Unknown、Immediate、Near和Far。Immediate是半米以内，Near远一些，Far更远。RSSI是信号强度。

 

运行程序

现在这个app可以运行了。但是需要分别运行在两台可以兼容低功耗蓝牙的设备上。一台当基站一台当接收机。

 

当你从足够远（10～20米）的地方想基站的方向走的时候，一个你”didEnterRange”那个didRangeBeacons方法就会被调用，这是就可以从方法中传入的beacon数组中取出值来现实在界面上。

 

但是有一点需要注意的是，我们处理的基站只有一个，所以每次都取出beacon数组的最后一个。如果有多个beacon基站的话就需要循环beacon数组的每一个元素，判断这个元素的proximity是Immdiate还是Near还是Far等。

 

每次测试的时候都进入或者离开一个区域太麻烦。可以在viewDidLoad方法中添加一行代码：

然后添加如下方法：

手动调用了didStartMonitoringForRegion，在这个方法中调用了trackLocationManager的startRangingBeaconsInRegion方法。这样虽然不完美，但是足够测试了。

 

下面是代码列表：

ConfigViewController:

import UIKit
import CoreLocation
import CoreBluetooth

class ConfigViewController: UIViewController, CBPeripheralManagerDelegate {

     // properties
     @IBOutlet var uuidLabel: UILabel
     @IBOutlet var majorLabel: UILabel
     @IBOutlet var minorLabel: UILabel
     @IBOutlet var identityLabel: UILabel
     @IBOutlet var transmitButton: UIButton

     var beaconRegion : CLBeaconRegion!
     var beaconPeripheralData : NSDictionary!
     var peripheralManager : CBPeripheralManager!

     override func viewDidLoad() {
         super.viewDidLoad()

         self.initBeacon()
         self.setLabels()
     }

     func initBeacon(){
         self.beaconRegion = CLBeaconRegion(proximityUUID: NSUUID(UUIDString: "206A2476-D4DB-42F0-BF73-030236F2C756")
             , major: 1, minor: 1, identifier: "com.mybeacon.region")
     }

     func setLabels(){
         self.uuidLabel.text = self.beaconRegion.proximityUUID.UUIDString
         self.majorLabel.text = self.beaconRegion.major.stringValue
         self.minorLabel.text = self.beaconRegion.minor.stringValue
         self.identityLabel.text = self.beaconRegion.identifier
     }

     override func didReceiveMemoryWarning() {
         super.didReceiveMemoryWarning()
         // Dispose of any resources that can be recreated.
     }

     @IBAction func transmitAction(sender: UIButton) {
         self.beaconPeripheralData = self.beaconRegion.peripheralDataWithMeasuredPower(nil)
         self.peripheralManager = CBPeripheralManager(delegate: self, queue: nil, options: nil)
     }

     // delegate methods
     func peripheralManagerDidUpdateState(peripheral: CBPeripheralManager!){
         if peripheral.state == CBPeripheralManagerState.PoweredOn {
             println("Powered on")
             self.peripheralManager.startAdvertising(self.beaconPeripheralData)
         }
         else if peripheral.state == CBPeripheralManagerState.PoweredOff {
             println("Powered off")
             self.peripheralManager.stopAdvertising()
         }
     }
 }

TrackViewController：

import UIKit
import CoreLocation

class TrackViewController: UIViewController, CLLocationManagerDelegate {

    @IBOutlet var beaconLabel: UILabel
    @IBOutlet var uuidLabel: UILabel
    @IBOutlet var majorLabel: UILabel
    @IBOutlet var minorLabel: UILabel
    @IBOutlet var accuracyLabel: UILabel
    @IBOutlet var distanceLabel: UILabel
    @IBOutlet var rssiLabel: UILabel

    var beaconRegion : CLBeaconRegion!
    var trackLocationManager : CLLocationManager!

    override func viewDidLoad() {
        super.viewDidLoad()

        self.trackLocationManager = CLLocationManager();
        self.trackLocationManager.delegate = self;
        self.initRegion()
        self.locationManager(self.trackLocationManager, didStartMonitoringForRegion: self.beaconRegion)
    }

    func initRegion(){
        var uuid = NSUUID(UUIDString: "206A2476-D4DB-42F0-BF73-030236F2C756")
        self.beaconRegion = CLBeaconRegion(proximityUUID: uuid, identifier: "com.mybeacon.region")
        self.trackLocationManager.startMonitoringForRegion(self.beaconRegion)
    }

    func locationManager(manager: CLLocationManager!, didStartMonitoringForRegion region: CLRegion!) {
        self.trackLocationManager.startRangingBeaconsInRegion(self.beaconRegion)
    }

    override func didReceiveMemoryWarning() {
        super.didReceiveMemoryWarning()
        // Dispose of any resources that can be recreated.
    }

    func locationManager(manager: CLLocationManager!, didEnterRegion region: CLRegion!) {
        self.trackLocationManager.startRangingBeaconsInRegion(self.beaconRegion)
    }

    func locationManager(manager: CLLocationManager!, didExitRegion region: CLRegion!) {
        self.trackLocationManager.stopRangingBeaconsInRegion(self.beaconRegion)
        self.beaconLabel.text = "No"
    }

    func locationManager(manager: CLLocationManager!, didRangeBeacons beacons: [AnyObject]!, inRegion region: CLBeaconRegion!) {
        println("beacons count" + String(beacons.count))
        if beacons.count <= 0 {
            return
        }

        var beacon: AnyObject = beacons[beacons.count - 1]

        self.beaconLabel.text = "Yes"
        self.uuidLabel.text = beacon.proximityUUID ? beacon.proximityUUID!.UUIDString : ""
        self.majorLabel.text = beacon.major ? beacon.major!.stringValue : ""
        self.minorLabel.text = beacon.minor ? beacon.minor!.stringValue : ""
        self.accuracyLabel.text = beacon.accuracy ? String(beacon.accuracy) : ""
        if beacon.proximity {

            switch(beacon.proximity!){
            case .Unknown:
                self.distanceLabel.text = "Unknown proximity"
            case CLProximity.Immediate:
                self.distanceLabel.text = "Immediate"
            case CLProximity.Near:
                self.distanceLabel.text = "Near"
            case CLProximity.Far:
                self.distanceLabel.text = "Far"
            default:
            }
        }
        self.rssiLabel.text = beacon.rssi ? beacon.rssi!.description : ""
    }
}

 

 

CocoaChina是全球最大的苹果开发中文社区，官方微信每日定时推送各种精彩的研发教程资源和工具，介绍app推广营销经验，最新企业招聘和外包信息，以及Cocos2d引擎、Cocos Studio开发工具包的最新动态及培训信息。关注微信可以第一时间了解最新产品和服务动态，微信在手，天下我有！

请搜索微信号“CocoaChina”关注我们！