计时器 Clock
提供时间和计时器功能。
属性
- 是否能在后台触发事件 TimerAlwaysFires 布尔 如果为真，即使应用程序未在屏幕上显示，也会触发
- 是否启用计时 TimerEnabled 布尔 指定计时器事件是否应运行。
- 计时间隔 TimerInterval 数字 定时器事件之间的间隔（以毫秒为单位）
事件
- 到计时间隔点 Timer 定时器已经响了。
方法
- 当前毫秒时间 SystemTime 数字 返回手机的内部时间。
- 当前日历 Now InstantInTime 从手机时钟读取的当前时间
- 文本转为日历 MakeInstant InstantInTime 日期文本 from: 文本 日期格式字符为 'MM/dd/yyyy HH:mm:ss'或'MM/dd/yyyy HH:mm'或'MM/dd/yyyy'或'HH:mm'
- 生成日历 MakeDate InstantInTime 年 year: 数字, 月 month: 数字, 日 day: 数字 返回由UTC中的年份、月份、日期指定的时间点。月份字段的有效值为1-12，日期字段的有效值为1-31。
- 生成日历 MakeTime InstantInTime 时 hour: 数字, 分 minute: 数字, 秒 second: 数字 允许用户设置时钟的时间 - 有效格式为hh:mm:ss
- 生成日历 MakeInstantFromParts InstantInTime 年 year: 数字, 月 month: 数字, 日 day: 数字, 时 hour: 数字, 分 minute: 数字, 秒 second: 数字 允许用户设置时钟打开时显示的日期和时间。
- 毫秒时间转为日历 MakeInstantFromMillis InstantInTime 毫秒数 millis: 数字 自1970年以来以毫秒为单位的特定时刻。
- 日历转为毫秒时间 GetMillis 数字 日历 instant: InstantInTime 自1970年以来以毫秒为单位的即时时间测量。
- 增加毫秒 AddDuration InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 返回参数之后某个持续时间的瞬间
- 增加秒数 AddSeconds InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争吵后几秒钟的一个瞬间
- 增加分数 AddMinutes InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争吵后几分钟的一个瞬间
- 增加时数 AddHours InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争吵后几个小时的某个瞬间
- 增加天数 AddDays InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争吵后几天的一个瞬间
- 增加周数 AddWeeks InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争论几周后的一瞬间
- 增加月数 AddMonths InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争论几个月后的一瞬
- 增加年数 AddYears InstantInTime 日历 instant: InstantInTime, 数量 quantity: 数字 争论几年后的一瞬
- 计算毫秒时间差 Duration 数字 开始日历 startCalendar: InstantInTime, 结束日历 endCalendar: InstantInTime 两个时刻之间经过的毫秒数
- 毫秒转为秒 DurationToSeconds 数字 毫秒时间 duration: 数字 将时长转换为秒
- 毫秒转分钟 DurationToMinutes 数字 毫秒时间 duration: 数字 将时长转换为分钟
- 毫秒转小时 DurationToHours 数字 毫秒时间 duration: 数字 将时长转换为小时
- 毫秒转为天 DurationToDays 数字 毫秒时间 duration: 数字 将时长转换为天数
- 毫秒转为周 DurationToWeeks 数字 毫秒时间 duration: 数字 将时长转换为周数
- 获取秒值 Second 数字 日历 instant: InstantInTime 分秒中的第二秒
- 获取分钟值 Minute 数字 日历 instant: InstantInTime 返回给定日期的分钟数。
- 获取小时值 Hour 数字 日历 instant: InstantInTime 返回给定日期的时数。
- 获取天值 DayOfMonth 数字 日历 instant: InstantInTime 返回某月的第几天。
- 获取星期值 Weekday 数字 日历 instant: InstantInTime 返回给定时刻的星期几。
- 获取星期名 WeekdayName 文本 日历 instant: InstantInTime 返回给定时刻的星期几名称。
- 获取月份值 Month 数字 日历 instant: InstantInTime 返回给定时刻对应的月份编号。
- 获取月份名 MonthName 文本 日历 instant: InstantInTime 返回给定瞬间的月份名称。
- 获取年份 Year 数字 日历 instant: InstantInTime 返回给定瞬间的年份。
- 转为日期时刻文本 FormatDateTime 文本 日历 instant: InstantInTime, 格式 pattern: 文本 使用指定的模式将瞬间转换为日期和时间字符串并进行格式化。要了解更多关于有效模式的信息，请参阅 SimpleDateFormat。
- 转为日期文本 FormatDate 文本 日历 instant: InstantInTime, 格式 pattern: 文本 格式化日期
- 转为时刻文本 FormatTime 文本 日历 instant: InstantInTime 将给定的瞬间转换为具有指定模式的字符串，并对其进行格式化。要了解有关有效模式的更多信息，请参阅 SimpleDateFormat。
计步器 Pedometer
此组件使用加速计记录步数。
属性
- 距离 Distance 数字 只代码, 只读 返回 approx我m在e 距离 traveled 米.
- 耗时 ElapsedTime 数字 只代码, 只读 自计步器启动以来经过的时间（以毫秒计）。
- 简单计步 SimpleSteps 数字 只代码, 只读 自计步器启动以来所走的简单步数。
- 检测超时停机 StopDetectionTimeout 数字 返回空闲时间（未检测到任何步骤），之后进入“停止”状态。
- 步幅 StrideLength 数字 如果已校准，则返回步幅长度的当前估计值（单位为米），否则返回默认值（0.73米）。
- 步数 WalkSteps 数字 只代码, 只读 自计步器启动以来所走的步数。
事件
- 检测简单步数 SimpleStep 简单步数 simpleSteps: 数字, 距离 distance: 数字 当检测到原始步骤时，此事件会被触发。
- 检测行走步数 WalkStep 行走步数 walkSteps: 数字, 距离 distance: 数字 当检测到步行步时，会运行此事件。步行步是指似乎与向前运动有关的一步。
方法
- 开始 Start 开始s pedo米.
- 停止 Stop 停止s pedo米.
- 复位 Reset 重置步数计数器、距离测量和时间运行。
- 保存 Save 将计步器状态保存到手机中。允许在使用计步器的应用程序调用之间累积步数和距离。不同的应用程序将保存各自的保存状态。
位置传感器 LocationSensor
提供位置信息的不可见组件，包括纬度、经度、高度（如果设备支持）、速度（如果设备允许）和地址。这也可以执行“地理编码”，将给定的地址（不一定是当前地址）转换为纬度（使用LatitudeFromAddress方法）和经度（使用LongitudeFromAddress法）。
属性
- 精度 Accuracy 数字 只代码, 只读 LocationSensor将能够根据卫星、蜂窝塔和其他用于估计位置的数据的质量，以不同程度的置信度定位设备。精度值是传感器检测位置周围的半径，单位为米。该设备有68%的机会位于该半径内。更精确的位置检测将导致更小的准确度，这使应用程序对设备实际位置更有信心。如果精度未知，则返回值为0.0
- 海拔 Altitude 数字 只代码, 只读 设备的高度以米为单位测量（如果可用）。高度是从世界大地测量系统84参考椭球面测量的，而不是海平面。请注意，设备很难准确地感知高度。手机/平板电脑上报告的高度很容易偏离30米或更远。
- 有效提供者列表 AvailableProviders 列表 只代码, 只读 可用服务提供商列表，如gps或网络。此信息以列表和文本形式提供。
- 当前地址 CurrentAddress 文本 只代码, 只读 谷歌地图数据库中设备的实际街道地址。地址可能并不总是可以从提供商处获得，报告的地址也可能并不总是设备所在建筑物的地址。如果Google没有特定位置的可用地址信息，则将返回no address available。
- 定位间距 DistanceInterval 数字 确定传感器将尝试用于发送位置更新的最小距离间隔（以米为单位）。例如，如果将其设置为50，则传感器仅在穿越50米后才会触发LocationChanged事件。然而，传感器不能保证以精确的距离间隔接收更新。例如，发射一个事件可能需要5米以上的距离。使用此属性时，检查准确性也很有用。当您的设备移动时，检测到的位置的准确性会不断变化。
- 是否启用 Enabled 布尔 如果为真，LocationSensor将尝试从GPS、WiFi位置或设备上可用的其他方式读取位置信息。此设置不控制位置信息是否实际可用。必须在设备设置中启用或禁用设备位置。
- 是否有精度数据 HasAccuracy 布尔 只代码, 只读 如果为真，该设备可以报告其准确度等级。
- 是否有海拔数据 HasAltitude 布尔 只代码, 只读 如果为真，该设备可以报告其高度。
- 是否有经纬度数据 HasLongitudeLatitude 布尔 只代码, 只读 如果为真，设备可以报告经度和纬度。通常情况下，要么两者都不是。
- 纬度 Latitude 数字 只代码, 只读 最近可用的纬度值，以度为单位，保留5位小数。若无可用值，则返回0。纬度值介于90（北）和-90（南）之间，其中0表示赤道。
- 经度 Longitude 数字 只代码, 只读 最近可用的经度值（以度为单位）报告到小数点后5位。如果没有可用值，将返回0。经度是介于180（东）和-180（西）之间的值，其中0表示本初子午线。
- 是否锁定提供者 ProviderLocked 布尔 只代码 设备不会更改服务提供商。当当前提供商无法提供足够的位置信息时，设备可以切换服务提供商。ProviderLocked是一个布尔值：true/false。设置为true可防止提供程序更改。设置为false，以便在必要时自动切换。
- 提供者名称 ProviderName 文本 只代码 当前的服务提供商。供应商很可能是GPS或网络。
- 时间间隔 TimeInterval 数字 确定传感器将尝试用于发送位置更新的最小时间间隔（毫秒）。但是，只有当手机的位置实际发生变化时，才会收到位置更新，并且不能保证使用指定的时间间隔。例如，如果使用30000作为时间间隔，则位置更新将永远不会在30000毫秒之前触发，但它们可能会在之后的任何时间触发。对于大多数设备来说，小于30000ms（30秒）的值是不切实际的。小值可能会耗尽电池并使GPS工作过度。
事件
- 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
- 位置被更改 LocationChanged 纬度 latitude: 数字, 经度 longitude: 数字, 海拔 altitude: 数字, 速度 speed: 数字 表示已检测到新位置。速度以米/秒为单位报告。其他值与其属性匹配。
- 状态被改变 StatusChanged 提供者 provider: 文本, 状态 status: 文本 表明位置提供程序服务的状态已发生变化，例如在
方法
- 由地址求纬度 LatitudeFromAddress 数字 位置名称 locationName: 文本 从给定的locationName推导出纬度。
- 由地址求经度 LongitudeFromAddress 数字 位置名称 locationName: 文本 从给定的locationName导出经度。
方向传感器 OrientationSensor
检测设备方向。
属性
- 角度 Angle 数字 只代码, 只读 返回一个角度，该角度告诉设备平铺的方向。也就是说，它“告诉”了在设备表面滚动的球所感受到的力的方向。
- 是否可用 Available 布尔 只代码, 只读 指示设备上是否存在方向传感器。
- 方位角 Azimuth 数字 只代码, 只读 返回设备的方位角。要返回有意义的值，必须启用传感器。
- 是否启用 Enabled 布尔 指定是否启用方向传感器。
- 幅度 Magnitude 数字 只代码, 只读 返回一个介于0和1之间的数字，指示设备倾斜的程度。它给出了球在设备表面滚动时所感受到的力的大小。对于倾斜角度，请使用“角度”。
- 音调 Pitch 数字 只代码, 只读 返回设备的俯仰角。要返回有意义的值，必须启用传感器。
- 翻转角 Roll 数字 只代码, 只读 返回设备的侧倾角。要返回有意义的值，必须启用传感器。
事件
- 方向被改变 OrientationChanged 方位角 azimuth: 数字, 倾斜角 pitch: 数字, 翻转角 roll: 数字 当方向发生改变时，OrientationChanged事件处理程序会运行。
距离传感器 ProximitySensor
一种传感器组件，可以测量物体相对于设备显示屏的接近度（单位为厘米）。该传感器通常用于确定手机是否被举到人的耳朵上；即，允许您确定对象与设备的距离。许多设备返回绝对距离，单位为厘米，但有些设备只返回近距离和远距离值。在这种情况下，传感器通常在远状态下报告其最大范围值，在近状态下报告较小的值。它报告了以下值：
属性
- 是否可用 Available 布尔 只代码, 只读 报告设备是否具有接近传感器。
- 距离 Distance 数字 只代码, 只读 返回从对象到设备的距离。必须启用传感器才能返回有意义的值。
- 是否启用 Enabled 布尔 如果为真, 传感器 将 生成 事件. 否则, 否 事件 是生成d.
- 是否保持运行 KeepRunningWhenOnPause 布尔 返回keepRunningWhenPause的值。
- 最大范围 MaximumRange 数字 只代码, 只读 报告设备接近传感器的最大范围
事件
- 距离改变 ProximityChanged 距离 distance: 数字 当物体与设备的距离（以厘米为单位）发生变化时触发。
光线传感器 LightSensor
可以测量光照水平的物理世界组件。
属性
- 是否可用 Available 布尔 只代码, 只读 指定设备是否具有支持LightSensor组件的硬件。
- 平均光照度（勒克斯） AverageLux 数字 只代码, 只读 通过平均前10个测量值来返回亮度（勒克斯）。传感器必须启用并可用，以返回有意义的值。
- 是否启用 Enabled 布尔 指定是否 传感器 应该 生成 事件. 如果为真, 传感器 将 生成 事件. 否则, 否 事件 是生成d.
- 光照度（勒克斯） Lux 数字 只代码, 只读 返回上次测量的亮度（勒克斯）。传感器必须启用并可用，以返回有意义的值。
- 刷新间隔（毫秒） RefreshTime 数字 报告读数变化之间请求的最短时间（毫秒）。Android不能保证满足这一要求。设置此属性对Gingerbread之前的设备没有影响。
事件
- 光照度改变 LightChanged 光照度 lux: 数字 指示 浅 级别 改变.
声音传感器 SoundSensor
声音传感器，用于测量环境声音强度。
属性
- 是否启用 Enabled 布尔 暂无描述
- 最大振幅 MaxAmplitude 数字 只代码, 只读 声音振幅，0 到 32768
- 最大音量（分贝） MaxDecibel 数字 只代码, 只读 最大声音分贝
- 平均振幅 MeanAmplitude 数字 只代码, 只读 声音振幅，0 到 32768
- 平均音量（分贝） MeanDecibel 数字 只代码, 只读 平均声音分贝
- 刷新间隔（毫秒） RefreshTime 数字 暂无描述
事件
- 音量变化 SoundChanged 平均音量 meanDecibel: 数字, 最大音量 maxDecibel: 数字 音量变化时触发
气压传感器 Barometer
物理世界组件，如果硬件支持，可以测量环境气压。
属性
- 气压（毫巴） AirPressure 数字 只代码, 只读 如果传感器可用且已启用，则显示大气压力，单位为hPa（毫巴）。
- 是否可用 Available 布尔 只代码, 只读 指定设备是否具备支持气压计组件的硬件。
- 是否启用 Enabled 布尔 指定传感器是否应生成事件。如果为真，则传感器将生成事件。否则，不会生成任何事件。
- 刷新间隔（毫秒） RefreshTime 数字 所请求的报告读数变化之间的最小时间间隔（以毫秒为单位）。Android 不保证会遵守此请求。在 Gingerbread 之前的设备上，设置此属性无效。
事件
- 气压改变 AirPressureChanged 气压 pressure: 数字 当检测到气压（以百帕为单位）发生变化时调用。
温度传感器 Thermometer
如果硬件支持，可以测量环境空气温度的物理世界组件。
属性
- 是否可用 Available 布尔 只代码, 只读 指定设备是否具有支持温度计组件的硬件。
- 是否启用 Enabled 布尔 指定是否 传感器 应该 生成 事件. 如果为真, 传感器 将 生成 事件. 否则, 否 事件 是生成d.
- 刷新间隔（毫秒） RefreshTime 数字 报告读数变化之间请求的最短时间（毫秒）。Android不能保证满足这一要求。设置此属性对Gingerbread之前的设备没有影响。
- 温度（摄氏） Temperature 数字 只代码, 只读 返回以摄氏度为单位的温度。传感器必须启用并可用，以返回有意义的值。
事件
- 温度改变 TemperatureChanged 温度 temperature: 数字 表示温度变化，单位为摄氏度。
湿度传感器 Hygrometer
如果硬件支持，可以测量相对环境空气湿度的物理世界组件。
属性
- 是否可用 Available 布尔 只代码, 只读 指定设备是否具有支持湿度计组件的硬件。
- 是否启用 Enabled 布尔 指定是否 传感器 应该 生成 事件. 如果为真, 传感器 将 生成 事件. 否则, 否 事件 是生成d.
- 湿度（百分比） Humidity 数字 只代码, 只读 以百分比形式返回相对环境湿度。传感器必须启用并可用，以返回有意义的值。
- 刷新间隔（毫秒） RefreshTime 数字 报告读数变化之间请求的最短时间（毫秒）。Android不能保证满足这一要求。设置此属性对Gingerbread之前的设备没有影响。
事件
- 湿度改变 HumidityChanged 湿度 humidity: 数字 表示相对湿度变化。
磁场传感器 MagneticFieldSensor
磁场传感器组件
属性
- 绝对强度 AbsoluteStrength 数字 只代码, 只读 表示场的绝对强度。
- 是否可用 Available 布尔 只代码, 只读 表示设备中装有磁场传感器，且该传感器可用。
- 是否启用 Enabled 布尔 指示磁场传感器是否启用并工作。
- 最大范围 MaximumRange 数字 只代码, 只读 表示磁传感器可达到的最大范围。
- X强度 XStrength 数字 只代码, 只读 表示该字段在X轴上的强度。
- Y强度 YStrength 数字 只代码, 只读 表示字段在Y轴上的强度。
- Z强度 ZStrength 数字 只代码, 只读 表示该场在Z轴上的强度。
事件
- 磁场强度改变 MagneticChanged X强度 xStrength: 数字, Y强度 yStrength: 数字, Z强度 zStrength: 数字, 绝对强度 absoluteStrength: 数字 当磁场发生变化时触发，在参数中设置新值。
指纹传感器 FingerprintSensor
指纹传感器，安卓6以上才能使用
属性
- 是否已录入指纹 HasEnrolledFingerprints 布尔 只代码, 只读 检测是否已经录入指纹
- 是否有指纹传感器 HasFingerprintSensor 布尔 只代码, 只读 检测是否有指纹传感器
- 是否正在授权 IsAuthenticating 布尔 只代码, 只读 是否正在授权
- 是否已启用锁屏密码 IsKeyguardSecure 布尔 只代码, 只读 检测是否已经开启锁屏密码
事件
- 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
- 授权成功 OnAuthenticationSucceeded 指纹授权成功
- 授权失败 OnAuthenticationFailed 指纹授权失败
- 授权异常 OnAuthenticationHelp 错误编号 errorNumber: 数字, 消息 message: 文本 授权时出现可恢复的异常，如“指纹传感器太脏，请清洁”
方法
- 开始授权 Authenticate 开始指纹授权
- 取消授权 CancelAuthentication 取消授权
加速度传感器 AccelerometerSensor
不可见组件，可以检测震动，并使用国际单位制（m/s2）在三维空间内测量加速度。组件包括：
属性
- 是否可用 Available 布尔 只代码, 只读 返回设备上AccelerometerSensor（加速度传感器）硬件是否可用。
- 是否启用 Enabled 布尔 指定传感器是否应生成事件。如果为真，则传感器将生成事件。否则，即使设备被加速或摇晃，也不会生成任何事件。
- 最小间隔（毫秒） MinimumInterval 数字 指定连续两次摇晃事件之间所需的最小间隔时间（以毫秒为单位）。一旦手机开始被摇晃，所有后续的摇晃事件都将被忽略，直至达到设定的间隔时间。
- 敏感度 Sensitivity 数字 指定加速度计的灵敏度。有效值包括：1（弱）、2（中）和3（强）。
- X分量 XAccel 数字 只代码, 只读 返回X轴方向的加速度，单位为国际单位制（m/s²）。传感器必须启用才能返回有意义的数据。
- Y分量 YAccel 数字 只代码, 只读 返回Y轴方向的加速度，单位为国际单位制（m/s²）。传感器必须启用才能返回有意义的数据。
- Z分量 ZAccel 数字 只代码, 只读 返回Z轴方向的加速度，单位为国际单位制（m/s²）。传感器必须启用才能返回有意义的数据。
事件
- 加速被改变 AccelerationChanged X分量 xAccel: 数字, Y分量 yAccel: 数字, Z分量 zAccel: 数字 表示加速度在X、Y和/或Z维度上发生了变化。
- 被晃动 Shaking 表示设备开始被摇晃或持续被摇晃。
陀螺仪传感器 GyroscopeSensor
提供设备陀螺仪传感器数据的组件。
属性
- 是否可用 Available 布尔 只代码, 只读 指示 是否 gyroscope 传感器 是可用.
- 是否启用 Enabled 布尔 启用 属性 获取ter 方法.
- X角速度 XAngularVelocity 数字 只代码, 只读 绕X轴的角速度，单位为度/秒。
- Y角速度 YAngularVelocity 数字 只代码, 只读 绕Y轴的角速度，单位为度/秒。
- Z角速度 ZAngularVelocity 数字 只代码, 只读 绕Z轴的角速度，单位为度/秒。
事件
- 陀螺仪状态改变 GyroscopeChanged X轴角速度 xAngularVelocity: 数字, Y轴角速度 yAngularVelocity: 数字, Z轴角速度 zAngularVelocity: 数字, 纳秒运行时间 timestamp: 数字 表示陀螺仪传感器数据已发生变化。timestamp参数是事件发生时的纳秒时间。
近场通信（NFC） NearField
提供NFC功能的不可见组件。目前，该组件仅支持读取和写入文本标签（如果设备支持）。
属性
- 是否有传感器 HasNfcCapability 布尔 只代码, 只读 暂无描述
- 是否已启用 IsNfcEnabled 布尔 只代码, 只读 暂无描述
- 最新信息 LastMessage 文本 只代码, 只读 返回 内容 的 大多数 recently 接收d 标签.
- 是否启用读值模式 ReadMode 布尔 指定NFC硬件应以读取模式还是写入模式运行。
- 写入文本 TextToWrite 文本 只代码 指定在写入模式下将写入标记的内容。如果ReadMode为真，则此方法无效。
事件
- 出错 OnError 函数名称 functionName: 文本, 错误编号 errorNumber: 数字, 消息 message: 文本 暂无描述
- 读到标签 TagRead 消息 message: 文本 表示已检测到新标记。目前，这只是清单中指定的纯文本标记。
- 写入标签 TagWritten 表示标签已进入NFC传感器的范围并已写入。