开发者在挂载TencentLocationService.cs脚本的GameObject上挂载一个自己实现的脚本，在脚本中开启定位、获取定位结果、结束定位。

开启定位

TencentLocationService.cs挂载到任意一个GameObject上，GameObject运行时，定位服务会自动进行初始化，当定位状态处于Ready状态，打开定位才有效。判断定位是否处于ready状态的方法如下：

tencentLocationService.status == TencentLocationServiceStatus.Ready

开启定位

tencentLocationService.Start(float desiredAccuracyInMeters = -1f, float updateDistanceInMeters = -1f)

• desiredAccuracyInMeters: 期待的定位精度，例如设置30，返回的定位数据都是精度误差小于等于30米的，不设置时默认为-1，返回所有精度的定位数据。
• updateDistanceInMeters：最小更新距离，例如设置10，当移动的距离超过10米，才会返回定位数据，不设置时默认为-1，有位置更新就返回。

获取定位数据

更新的定位数据封装在TencentLocationInfo中。

1. 主动获取最后一次定位结果

tencentLocationService.lastData;

2. 通过回调实时获取定位结果

挂载TencentLocationService.cs脚本的GameObject上挂载的脚本需要实现接口 ILocationListener.OnLocationUpdate(string locInfo)

public class TestLocation : MonoBehaviour, ILocationListener{ ... public void OnLocationUpdate(string locInfo) { //采用提供的解析工具，解析出TencentLocationInfo定位数据对象 TencentLocationInfo location = Util.ParseLocationInfo (locInfo); } ... }

定位回调结果如下图所示：

停止定位

tencentLocationService.Stop()

定位状态

通过tencentLocationService.status可以查看当前的定位状态，一共有5种定位状态:

public enum TencentLocationServiceStatus { /// <summary> /// 定位初始化 /// </summary> Initializing = 0, /// <summary> /// 定位准备就绪 /// 此时开始Start定位才有效果. /// </summary> Ready = 1, /// <summary> /// 定位正在进行中 /// </summary> Running = 2, /// <summary> /// 定位失败 /// </summary> Failed = 3, /// <summary> /// 定位停止 /// </summary> Stopped = 4 }

定位失败状态码

当定位失败，即tencentLocationService.status == TencentLocationServiceStatus.Failed时，可以通过tencentLocationService.errorCode查看定位失败的状态码，以便查看对应的原因;

例如：Api key配置不正确: tencentLocationService.errorCode == ErrorCode.API_KEY_ERROR;

public enum ErrorCode { /// <summary> /// 初始化 /// </summary> INITIALIZING = 0, /// <summary> /// 定位成功 /// </summary> OK_ERROR = 1, /// <summary> /// API_KEY 配置不正确, Android/iOS通用错误码 /// </summary> API_KEY_ERROR = 2, /// <summary> /// 网络错误引起的定位失败, Android/iOS通用错误码 /// </summary> NETWORK_ERROR = 3, /// <summary> /// Android加载so库失败; /// </summary> ANDROID_LOAD_SO_LIB_ERROR = 4, /// <summary> /// Android手机硬件不支持, 比如没有GPS硬件; /// </summary> ANDROID_HARDWARE_NOT_SUPPORTED = 5, /// <summary> /// GPS, Wi-Fi 或基站错误引起的定位失败： /// 1、用户的手机确实采集不到定位凭据，比如偏远地区比如地下车库电梯内等; /// 2、开关跟权限问题，比如用户关闭了位置信息，关闭了Wi-Fi，未授予app定位权限等。 /// </summary> ANDROID_BAD_JSON_ERROR = 6, /// <summary> /// Android无法将WGS84坐标转换成GCJ-02坐标时的定位失败; /// </summary> ANDROID_WGS84_ERROR = 7, /// <summary> /// iOS 定位权限被禁止 /// </summary> IOS_LOCATION_PERMISSION_DENIED_ERROR = 8, /// <summary> /// iOS目前位置未知，但是会一直尝试获取 /// </summary> IOS_CURRENT_LOCATION_UNKNOWN_ERROR = 9, /// <summary> /// iOS朝向无法确认; /// </summary> IOS_HEADING_FAILURE_ERROR = 10, /// <summary> /// api key 过期，试用版本的期限到了 /// </summary> API_KEY_EXPIRE = 11, /// <summary> /// 未知的错误，Android/iOS通用错误码 /// </summary> UNKNOWN_ERROR = 12 }

Tips

具体使用，可以参考提供的Demo工程.