基于Android P的Gps_Geofencing流程分析

1. 概述

GPS_Geofencing即地理围栏定位，其作用就是通过添加一个区域，如果位置不在此区域则上报通知信息。本文档重点是讲接口的调用流程，并不涉及到地理围栏的相关算法。

以下是基于android P分析的流程。

2. 框架分析

2.1功能入口

围栏定位的构造在LMS的函数loadProvidersLocked里面加载完成，如下图

config_enableGeofenceOverlay：如为false，则使用第三方网络定位

config_geofenceProviderPackageName：第三方网络定位包名

config_locationProviderPackageNames：默认的网络定位包名，如果config_enableNetworkLocationOverlay为true，则使用这个包名。

2.2框架流程

围栏定位可由第三方应用实现，Android默认系统不会提供此功能，框架见如下图。

 Google已帮实现接口层，见深蓝色部分，如要开发围栏功能，我们只需要实现IGeofenceProvider接口即可。

2.2类图

 GeofenceProxy类：从命名来看，是个代理，用来完成part2 part3 part4的功能。

Part1：实现JNI层的交互，并传递IGnssGeofenceProvider对象给part3

Part2：实现拉起第三方应用，开始围栏功能

Part3：封装IGnssGeofenceProvider接口，给part4提供IGeofenceHardware接口

Part4：第三方应用实现的围栏功能

2.3 ServiceWatcher代码分析

GeofenceProxy其实不直接跟IGeofenceProvider交互，而是通过代理ServiceWatcher跟它通信。

GeofenceProxy的createAndBind中有两个关键函数，分别是GeofenceProxy的构造函数以及bind。代码如下所示。

 proxy.bindGeofenceProvider()会调用ServiceWatcher的start，我们直接来看它。

 bindBestPackageLocked的工作包括如下。

·检查目标应用程序的签名。

·根据createAndBind第三个参数查找该目标应用程序实现的Service（Android四大组件之

一），即目标应用程序必须提供一个名为"com.android.location.service.GeofenceProvider"的服务。

·然后绑定到该服务上，并获取一个类型为IGeofenceProvider接口的实例。通过该实

例，GeofenceProxy可与位于应用程序交互。

bindBestPackageLocked中最重要的函数是bindToPackageLocked，其代码如下所示。

 绑定成功后，ServiceWathcer的onServiceConnected函数将被调用。

 mNewServiceWork是一个Runnable对象，它由GeofenceProxy提供，其代码如下所示。

 3. 接口说明

GPS_Geofencing的相关接口见如下图。

3.1 init函数指针

1）函数说明

描述	用于初始化回调函数，当底层有信息上报时，gps库会调用此回调函数的上报给上层
函数原型	void  (*init)( GpsGeofenceCallbacks* callbacks )
参数说明	callbacks	geofence_transition_callback	上报围栏状态，如在里面还是外面
		geofence_status_callback	GPS围栏是否可用状态
		geofence_add_callback	围栏添加状态回调
		geofence_remove_callback	围栏删除状态回调
		geofence_pause_callback	围栏暂停状态回调
		geofence_resume_callback	围栏恢复状态回调
返回值	void
说明

2）GpsGeofenceCallbacks结构体

3）调用逻辑

3.1.1 geofence_transition_callback回调函数

1）函数说明

描述	GPS围栏可用状态
函数原型	void (*gps_geofence_status_callback) (int32_t status, GpsLocation* last_location)
参数说明	status	围栏状态，取值GPS_GEOFENCE_UNAVAILABLE or GPS_GEOFENCE_AVAILABL
	location	GPS定位信息
返回值	void
说明

2）调用逻辑

3.1.2geofence_status_callback回调函数

1）函数说明

描述	上报围栏状态
函数原型	void (*gps_geofence_transition_callback) (int32_t geofence_id,  GpsLocation* location, int32_t transition, GpsUtcTime timestamp)
参数说明	geofence_id	围栏id，由应用层提供
	location	GPS定位信息
	transition	当前处于围栏的位置，取值：GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED,GPS_GEOFENCE_UNCERTAIN
	timestamp	时间
返回值	void
说明

2）调用逻辑

3.1.3 geofence_add_callback回调函数

1）函数说明

描述	围栏添加状态回调
函数原型	void (*gps_geofence_add_callback) (int32_t geofence_id, int32_t status)
参数说明	geofence_id	围栏id，由应用层提供
	status	GPS_GEOFENCE_OPERATION_SUCCESS GPS_GEOFENCE_ERROR_ID_UNKNOWN GPS_GEOFENCE_ERROR_GENERIC
返回值	void
说明

2）调用逻辑

见3.2章节

3.1.4 geofence_remove_callback回调函数

1）函数说明

描述	围栏删除状态回调
函数原型	void (*gps_geofence_remove_callback) (int32_t geofence_id, int32_t status)
参数说明	geofence_id	围栏id，由应用层提供
	status	GPS_GEOFENCE_OPERATION_SUCCESS GPS_GEOFENCE_ERROR_ID_UNKNOWN GPS_GEOFENCE_ERROR_GENERIC
返回值	void
说明

2）调用逻辑

见3.5章节

3.1.5 geofence_pause_callback回调函数

1）函数说明

描述	围栏删除状态回调
函数原型	void (*gps_geofence_pause_callback) (int32_t geofence_id, int32_t status)
参数说明	geofence_id	围栏id，由应用层提供
	status	GPS_GEOFENCE_OPERATION_SUCCESS GPS_GEOFENCE_ERROR_ID_UNKNOWN GPS_GEOFENCE_ERROR_GENERIC
返回值	void
说明

2）调用逻辑

见3.3章节

3.1.6 geofence_resume_callback回调函数

1）函数说明

描述	围栏删除状态回调
函数原型	void (*gps_geofence_resume_callback) (int32_t geofence_id, int32_t status)
参数说明	geofence_id	围栏id，由应用层提供
	status	GPS_GEOFENCE_OPERATION_SUCCESS GPS_GEOFENCE_ERROR_ID_UNKNOWN GPS_GEOFENCE_ERROR_GENERIC
返回值	void
说明

2）调用逻辑

见3.4章节

3.2 add_geofence_area添加围栏

1）函数说明

描述	添加一个围栏
函数原型	void (*add_geofence_area) (int32_t geofence_id, double latitude, double longitude,        double radius_meters, int last_transition, int monitor_transitions,        int notification_responsiveness_ms, int unknown_timer_ms)
参数说明	geofence_id	结构体内容见下图
	latitude	围栏id，由应用层提供
	longitude	纬度
	radius_meters	经度
	last_transition	半经
	monitor_transitions	监视过渡 GPS_GEOFENCE_ENTERED, GPS_GEOFENCE_EXITED GPS_GEOFENCE_UNCERTAIN.
	notification_responsiveness_ms	定义关于触发与Geofence关联的转换时应多长时间调用一次回调的尽力而为的描述。 例如，如果使用GPS_GEOFENCE_ENTERED设置为1000毫秒，则在输入地理围栏内应将回调称为1000毫秒。 此参数以毫秒为单位定义。 注意：请勿将其与GPS轮询的速率混淆。 出于节电的原因，可以动态改变GPS采样率； 因此，采样速率可能比此更快或更慢。
	unknown_timer_ms
返回值	void
说明

2）调用逻辑

3.3 pause_geofence停止围栏监听

1）函数说明

描述	停止某个围栏监听
函数原型	void (*pause_geofence) (int32_t geofence_id)
	geofence_id	围栏id，由应用层提供
返回值	void
说明

2）调用逻辑

3.4 resume_geofence恢复围栏状态

1）函数说明

描述	恢复指定的一个围栏状态
函数原型	void (*resume_geofence) (int32_t geofence_id, int monitor_transitions)
	geofence_id	围栏id，由应用层提供
	monitor_transitions	监视过渡
返回值	void
说明

2）调用逻辑

3.5 remove_geofence_area删除围栏

1）函数说明

描述	删除指定一个围栏
函数原型	void (*remove_geofence_area) (int32_t geofence_id)
	geofence_id	围栏id，由应用层提供
返回值	void
说明

2）调用逻辑

4 GPS库如何开发此功能

  因没有实质的应用场景，而且功能开发也需要模块支持，目前还未有实质代码，但可通过文字总结整理，为后续开发提供参考。具体可分为四步走。

  步骤一：实现gps.h的init函数的功能

  步骤二：实现GpsGeofencingInterface的相关函数指定内容

  步骤三：把实现好GpsGeofencingInterface接口添加到gps_get_extension里面。

  步骤四：开发APK来实现围栏功能

5 总结

以上就为GPS_Geofencing的总结，如有开发需求，参考如上流程开发。