快速入门 编辑文档

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

环境准备:

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

1. 创建应用

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


注意:


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

2. 安装SDK

通过CocoaPods安装:

Podfile 中加入

pod 'WilddogLocation'

保存文件,并执行 pod install

3. 初始化SDK

1. 引入头文件

AppDelegate.h中,引入:

#import <AMapFoundationKit/AMapFoundationKit.h>

ViewController.h中,引入:

#import <WilddogCore/WilddogCore.h>
#import <WilddogSync/WilddogSync.h>
#import <WilddogLocation/WilddogLocation.h>

2. 设置高德API Key

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

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

3. 初始化 Wilddog Location 服务

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

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

4. 位置上传

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

[locationService startTracingPositionForKey:@"key"];

5. 位置监听

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

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

WilddogHandle handle = [locationService observePositionForKey:@"key" withBlock:^(WDGPosition * _Nullable position, NSError * _Nullable error) {
NSLog(@"Current Position: %@", position);
}];
野狗新手?
立即注册,为你提供安全可靠的实时通信云服务。
没找到需要的文档?
你可以提交工单反馈 或 阅读常见问题