Android中文API(131) —— GpsStatus
前言
本章内容是android.location.GpsStatus,为GPS相关章节,版本为Android 3.2 r1,翻译来自"熊猫82",欢迎访问他的博客:"http://wisekingokok.cnblogs.com",再次感谢"熊猫82"!欢迎你一起参与Android的中文翻译,联系我over140@gmail.com。
声明
欢迎转载,但请保留文章原始出处:)
GpsStatus
译者署名:熊猫82
译者链接:http://wisekingokok.cnblogs.com
版本:Android 3.2 r1
结构
继承关系
public final class GpsStatus extends Object
java.lang.Object
android.location.GpsStatus
类概述
此类用于表述GPS引擎的当前状态,此类需要和GpsStatus.Listener接口结合使用。
常量
int GPS_EVENT_FIRST_FIX
当GPS系统模块接收到第一次GPS定位信息之后发送此事件码。调用getTimeToFirstFix()方法获取自GPS系统模块被开启至第一次定位所消耗的时间。
常量值:3(0x00000003)
int GPS_EVENT_SATELLITE_STATUS
周期性发送GPS卫星状态的事件码。调用getSatellites()方法获取每一颗定位卫星的各种状态。(译者注:此事件码需在获取到卫星状态之后,才会发送。在没有搜索到卫星的时候,不会发送此事件码。)
常量值:4 (0x00000004)
int GPS_EVENT_STARTED
当GPS系统模块被开启之后发送此事件码。
常量值:1 (0x00000001)
int GPS_EVENT_STOPPED
当GPS系统模块被关闭之后发送此事件码。
常量值:2 (0x00000002)
内部类
interface GpsStatus.Listener
用于接收当GPS状态发生改变时所发出的通知
interface GpsStatus.NmeaListener
用于从GPS接收NMEA信息。
公共方法
public int getMaxSatellites ()
返回通过getSatellites()方法返回的卫星列表的最大卫星数。
返回值
最大卫星数。
public Iterable<GpsSatellite> getSatellites ()
返回一组用于描述GPS引擎当前状态的卫星对象。
返回值
一组卫星对象。
public int getTimeToFirstFix ()
返回自GPS引擎最新启动以来至收到的首次定位所需的时间。
返回值
首次定位所需的时间
补充
文章精选
译者署名:熊猫82
译者链接:http://wisekingokok.cnblogs.com
版本:Android 3.2 r1
结构
继承关系
public static interface GpsStatus.Listener
android.location.GpsStatus.Listener
类概述
用于接收当GPS状态发生改变时所发出的通知。
公共方法
public abstract void onGpsStatusChanged (int event)
当GPS状态发生改变时会回调此方法。GPS状态改变时会发出下列四个事件码的其中一个:
* GPS_EVENT_STARTED
* GPS_EVENT_STOPPED
* GPS_EVENT_FIRST_FIX
* GPS_EVENT_SATELLITE_STATUS
可以在方法内部调用getGpsStatus(Gpsstatus)获取GPS状态信息。
参数
event GPS状态发生改变时的事件码.
GpsStatus.NmeaListener
译者署名:熊猫82
译者链接:http://wisekingokok.cnblogs.com
版本:Android 3.2 r1
结构
继承关系
public static interface GpsStatus.NmeaListener
android.location.GpsStatus.NmeaListener
类概述
用于从GPS中获取NMEA信息。NMEA 0183是一个与海洋电子设备进行通信的标准,通过一系列接口接收来自GPS的数据,是一种常见的方法。更多细节见NMEA0183。您可以实现这个接口,并调用addNmeaListener(GpsStatus.NmeaListener)从GPS引擎接收NMEA数据的。 (译者注:这里NMEA-0183协议为通常所说的GPS协议,参见这里。)
公共方法
public abstract void onNmeaReceived (long timestamp, String nmea)
(译者注:原文无说明。这个接口的此方法貌似是预留的一种规范,曾跟踪源码,发现在硬件访问层补充nmea_callback的代码,才能将数据传到应用上层
参数
timestamp 时间戳,单位为毫秒。
nmea nmea信息。
)