title: 快速入门

你可以通过一次简单的位置同步的来了解 Realtime Location 的用法。

环境准备：

  • 运行iOS9.0以上的设备或模拟器；
  • 电脑上安装了CocoaPods。

1. 创建应用

首先，你需要在控制面板中创建应用。

注意：

Realtime Location SDK 的位置获取依赖于高德定位SDK，需要在应用中设置高德定位的 API Key。如果没有，请先在高德开放平台中获取。

2. 安装SDK

通过CocoaPods安装：

在 Podfile 中加入

  1. pod 'WilddogLocation'

保存文件，并执行 pod install。

3. 初始化SDK

1. 引入头文件

在AppDelegate.h中，引入：

  1. #import <AMapFoundationKit/AMapFoundationKit.h>

在ViewController.h中，引入:

  1. #import <WilddogCore/WilddogCore.h>
  2. #import <WilddogSync/WilddogSync.h>
  3. #import <WilddogLocation/WilddogLocation.h>

2. 设置高德API Key

在AppDelegate.m中的-application:didFinishLaunchingWithOptions:中添加：

  1. [AMapServices sharedServices].apiKey = @"Your-AMap-API-Key";

3. 初始化 Wilddog Location 服务

使用在第一步中创建的野狗应用ID，即可初始化服务。

  1. // 初始化Wilddog Sync
  2. WDGOptions *option = [[WDGOptions alloc] initWithSyncURL:@"https://YourAppID.wilddogio.com"];
  3. [WDGApp configureWithOptions:option];
  4. WDGSyncReference *ref = [[WDGSync sync] reference];
  5. // 使用Sync Reference初始化Wilddog Location
  6. WDGLocation *locationService = [[WDGLocation alloc] initWithSyncReference:ref];

4. 位置上传

- startTracingPositionForKey:方法可以根据 Key 向云端持续上传设备的位置，如果 Key 不存在，云端会自动创建。默认为 5s 上传一次位置数据。

  1. [locationService startTracingPositionForKey:@"key"];

5. 位置监听

开启位置上传之后，你可以监听的 Key 的位置变化。

- observePositionForKey:withBlock: 用于实时获取指定 Key 的最新位置信息。

  1. WilddogHandle handle = [locationService observePositionForKey:@"key" withBlock:^(WDGPosition * _Nullable position, NSError * _Nullable error) {
  2.     NSLog(@"Current Position: %@", position);
  3. }];