title: 安装与初始化

本篇文档介绍如何安装和初始化 SDK。

1. 安装 SDK

Realtime Location SDK 提供标签引用和 npm 下载两种方式安装。

通过标签引用

实时定位 API 依赖于高德定位 SDK，因此需要按顺序引入：

  1. <script src="http://webapi.amap.com/maps?v=1.3&key=<AMapKey>"></script>
  1. <script src="https://cdn.wilddog.com/sdk/js/2.5.6/wilddog.js"></script>

  1. <script src="https://cdn.wilddog.com/sdk/js/0.1.0/wilddog-location.js"></script>

通过 npm 下载

1.安装依赖。

  1. npm install wilddog wilddog-location

2.在代码中注册 Realtime Location 服务。

  1. var wilddog = require('wilddog');
  2. var RealtimeLocation = require('wilddog-location');
  4. wilddog.regService('location', function(app) {
  5.   if (app == null) {
  6.     throw new Error('application not initialized!Please call wilddog.initializeApp first');
  7.     return;
  8.   };
  9.   return new RealtimeLocation(app);
  10. });
  11. wilddog.Location = RealtimeLocation;

3.在 html 中引用高德 api。

  1. <script src="http://webapi.amap.com/maps?v=1.3&key=<AMapKey>"></script>

注意：

引入高德定位 SDK 的时候，需要填入你高德应用的 AMapKey。如果没有，请在高德开放平台中获取。

2. 初始化 SDK

使用 Wilddog Location SDK 之前，需要先创建实例。

  1. var config = {
  2.   syncURL: "https://<appId>.wilddogio.com" //输入AppID
  3. };
  4. wilddog.initializeApp(config);
  5. // 注意类名不要覆盖全局的变量，如：location 和 Location
  6. var wildLocation = wilddog.location();

注意：

初始化需要野狗 AppID。野狗 AppID 野狗控制面板 应用中获取。