到顶部
Android API
公众的

电话管理器

延伸对象
java.lang.Object对象
   ↳ 安卓手机。电话管理器

课程概述

提供对上电话服务信息的访问设备。应用程序可以使用此类中的方法来确定电话服务和状态,以及访问一些订户信息的类型。应用程序也可以注册用于接收电话状态更改通知的侦听器。

您没有直接实例化这个类;相反,您可以检索通过引用实例Context.getSystemService(Context.TELEPHONY_SERVICE).

请注意,访问某些电话信息是许可受保护。您的应用程序无法访问受保护的信息,除非它具有中声明的适当权限它的清单文件。如果权限适用,则在访问受保护信息的方法。

总结

常量
字符串 动作_声音_状态_更改 广播意图动作指示呼叫状态(蜂窝)设备上的已更改。
字符串 动作RESPOND_VIA_MESSAGE 当用户在传入消息时选择通过消息响应时,手机应用程序会发送此意图呼叫。
整数 呼叫_状态_空闲 设备调用状态:无活动。
整数 呼叫状态_关闭 设备呼叫状态:离线。
整数 呼叫_状态_响铃 设备呼叫状态:正在振铃。
整数 数据_活动_通知 数据连接处于活动状态,但物理链路已断开
整数 数据活动 数据连接活动:当前正在接收IP PPP流量。
整数 数据_活动_输入 数据连接活动:当前发送和接收IP PPP流量。
整数 数据_活动_无 数据连接活动:无流量。
整数 数据_活动_输出 数据连接活动:当前正在发送IP PPP流量。
整数 数据_已连接 数据连接状态:已连接。
整数 数据_连接 数据连接状态:当前正在设置数据连接。
整数 数据_断开 数据连接状态:已断开连接。
整数 数据_取消 数据连接状态:已挂起。
字符串 额外编目编号 与一起使用的查找键动作_声音_状态_更改广播用于包含传入电话号码的字符串。
字符串 额外状态 与一起使用的查找键动作_声音_状态_更改广播用于包含新调用状态的字符串。
整数 网络类型_1xRTT 当前网络为1xRTT
整数 网络类型_CDMA 当前网络为CDMA:IS95A或IS95B
整数 网络类型_边缘 当前网络为EDGE
整数 网络类型_EHRPD 当前网络为eHRPD
整数 网络类型_EVDO_0 当前网络为EVDO版本0
整数 网络类型_EVDO_A 当前网络为EVDO版本A
整数 网络类型_EVDO_B 当前网络为EVDO修订版B
整数 网络类型_GPRS 当前网络为GPRS
整数 网络类型_HSDPA 当前网络为HSDPA
整数 网络类型_HSPA 当前网络为HSPA
整数 网络类型_HSPAP 当前网络为HSPA+
整数 网络类型_HSUPA 当前网络为HSUPA
整数 网络类型标识 当前网络是iDen
整数 网络类型_LTE 当前网络为LTE
整数 网络类型_UMTS 当前网络为UMTS
整数 网络类型未知 网络类型未知
整数 电话_类型_CDMA 手机收音机是CDMA。
整数 电话_类型_GSM 电话收音机是GSM。
整数 电话_类型_无 没有电话收音机。
整数 电话_类型_SIP 电话通过SIP。
整数 SIM_状态_不存在 SIM卡状态:设备中没有可用的SIM卡
整数 SIM_STATE_NETWORK_锁定 SIM卡状态:已锁定:需要网络PIN才能解锁
整数 SIM_状态_PIN_必需 SIM卡状态:已锁定:需要用户的SIM PIN才能解锁
整数 SIM_STATE_PUK_必需 SIM卡状态:已锁定:需要用户的SIM PUK才能解锁
整数 SIM_状态_就绪 SIM卡状态:就绪
整数 SIM_状态_未知 SIM卡状态:未知。
字段
公众的静止的最终的字符串 额外日期 与一起使用的值额外状态对应于呼叫_状态_空闲.
公众的静止的最终的字符串 额外_状态_关闭 与一起使用的值额外状态对应于呼叫状态挂起.
公众的静止的最终的字符串 额外状态_振铃 与一起使用的值额外状态对应于呼叫_状态_响铃.
公共方法
列表<手机信息> 获取所有手机信息()
从上的所有无线电返回所有观察到的小区信息包括主单元和相邻单元的设备。
整数 获取调用状态()
返回一个常数,指示设备上的通话状态(蜂窝)。
单元格位置 获取单元格位置()
返回设备的当前位置。
整数 获取数据活动()
返回一个常量,该常量指示数据连接上的活动类型(手机)。
整数 获取数据状态()
返回指示当前数据连接状态的常量(手机)。
字符串 获取设备ID()
返回唯一的设备ID,例如GSM的IMEI和MEID或用于CDMA手机的ESN。
字符串 获取设备软件版本()
返回设备的软件版本号,例如,GSM手机的IMEI/SV。
字符串 获取组ID级别1()
返回GSM电话的组标识符级别1。
字符串 获取行1编号()
返回第1行的电话号码字符串,例如MSISDN适用于GSM手机。
字符串 获取MmsUAProfUrl()
返回MMS用户代理配置文件URL。
字符串 获取MmsUserAgent()
返回MMS用户代理。
列表<相邻单元格信息> 获取相邻单元格信息()
返回设备的相邻单元格信息。
字符串 获取网络国家ISO()
返回当前注册的ISO国家代码等效值运营商的MCC(移动国家代码)。
字符串 获取网络运营商()
返回当前注册运算符的数字名称(MCC+MNC)。
字符串 获取网络运营商名称()
返回当前注册运算符的字母名称。
整数 获取网络类型()
整数 获取电话类型()
返回指示设备电话类型的常量。
字符串 获取模拟国家ISO()
返回与SIM卡提供商的国家代码等效的ISO国家代码。
字符串 getSim运算符()
返回的MCC+MNC(移动国家代码+移动网络代码)SIM卡的提供商。
字符串 获取Sim操作员名称()
返回服务提供商名称(SPN)。
字符串 获取SimSerialNumber()
返回SIM卡的序列号(如果适用)。
整数 获取模拟状态()
返回指示设备SIM卡。
字符串 获取订阅服务器ID()
返回唯一的用户ID,例如GSM电话的IMSI。
字符串 获取语音邮件AlphaTag()
检索与语音关联的字母标识符邮件号码。
字符串 获取语音邮件号码()
返回语音邮件号码。
布尔值 hasIcc卡()
布尔值 isNetworkRoaming(isNetwork漫游)()
如果设备被视为在当前网络,用于GSM目的。
空隙 (电话状态侦听器侦听器,int事件)
注册侦听器对象以接收更改通知处于指定的电话状态。
[展开]
继承的方法
来自班级java.lang.Object对象

常量

公众静态最终的字符串 动作_声音_状态_更改

广播意图动作指示呼叫状态(蜂窝)设备上的已更改。

这个额外状态extra表示新的呼叫状态。如果新状态为RINGING,则另加一个额外编目编号提供传入电话号码为a字符串。

需要READ_PHONE_STATE权限。

这是一个粘性的在1.0版中进行广播,但它不再具有粘性。相反,使用获取调用状态()同步查询当前通话状态。

常量值: “android.intent.action.PHONE_STATE”

公众静态最终的字符串 动作RESPOND_VIA_MESSAGE

已在中添加API等级18

当用户在传入消息时选择通过消息响应时,手机应用程序会发送此意图呼叫。默认情况下,设备的默认SMS应用程序使用此消息并发送文本消息打电话的人。第三方应用程序也可以通过使用此Intent提供此功能用一个服务并使用自己的消息传递系统发送消息。

意图包含URI(可从以下位置获得获取数据())使用短讯服务:,smsto公司:,彩信:,毫米至:URI架构。每个URI模式都携带接收者信息同样的方式:URI的路径部分包含收件人的电话号码或逗号分隔如果有多个收件人,则为一组电话号码。例如,短信:2065551234.

意图还可能包含消息文本的附加内容(在额外_文本)和消息主题(英寸额外_主题).

注:使用此intent的intent-filter需要位于服务这需要许可发送响应消息.

例如,可以在清单文件中声明接收此意图的服务使用这样的意向过滤器:

<!-- 提供从手机“快速响应”接收的SMS消息的服务--><service android:name=“.HeadlessSmsSendService”android:permission=“android.permission.SEND_RESPOND_VIA_MESSAGE”android:exported=“true”><意向过滤器><action android:name=“android.intent.action.RESPOND_VIA_MESSAGE”/><category android:name=“android.intentation.category.DEFAULT”/><data android:scheme=“sms”/><data android:scheme=“smsto”/><data android:scheme=“mms”/><data安卓:scheme=“mmsto”/></into-filter></服务>

输出:无。

常量值: “android.intent.action.RESPOND_VIA_MESSAGE”

公众静态最终整数呼叫_状态_空闲

已在中添加API级别1

设备调用状态:无活动。

常量值: 0(0x00000000)

公众静态最终整数呼叫状态_关闭

已在中添加API级别1

设备呼叫状态:离线。至少存在一个呼叫即正在拨号、活动或保持,且没有来电或等待。

常量值: 2(0x00000002)

公众静态最终整数呼叫_状态_响铃

已在中添加API级别1

设备呼叫状态:正在振铃。一个新电话来了,是铃声或等待。在后一种情况下,另一个调用是已激活。

常量值: 1(0x00000001)

公众静态最终整数数据_活动_通知

已在中添加API级别4

数据连接处于活动状态,但物理链路已断开

常量值: 4(0x00000004)

公众静态最终整数数据活动

已在中添加API级别1

数据连接活动:当前正在接收IP PPP流量。

常量值: 1(0x00000001)

公众静态最终整数数据_活动_输入

已在中添加API级别1

数据连接活动:当前发送和接收IP PPP流量。

常量值: (0x00000003)

公众静态最终整数数据_活动_无

已在中添加API级别1

数据连接活动:无流量。

常量值: 0(0x00000000)

公众静态最终整数数据_活动_输出

已在中添加API级别1

数据连接活动:当前正在发送IP PPP流量。

常量值: 2(0x00000002)

公众静态最终整数数据_已连接

已在中添加API级别1

数据连接状态:已连接。IP流量应可用。

常量值: 2(0x00000002)

公众静态最终整数数据_连接

已在中添加API级别1

数据连接状态:当前正在设置数据连接。

常量值: 1(0x00000001)

公众静态最终整数数据_断开

已在中添加API级别1

数据连接状态:已断开连接。IP流量不可用。

常量值: 0(0x00000000)

公众静态最终整数数据_取消

已在中添加API级别1

数据连接状态:已挂起。连接已建立,但IP流量暂时不可用。例如,在2G网络中,当语音呼叫到达时,数据活动可能会暂停。

常量值: (0x00000003)

公众静态最终的字符串 额外编目编号

与一起使用的查找键动作_声音_状态_更改广播用于包含传入电话号码的字符串。仅当新呼叫状态为RINGING时有效。

使用检索getStringExtra(字符串).

常量值: “incoming_number”

公众静态最终的字符串 额外状态

与一起使用的查找键动作_声音_状态_更改广播用于包含新调用状态的字符串。

常量值: “状态”

公众静态最终整数网络类型_1xRTT

已在中添加API级别4

当前网络为1xRTT

常量值: 7(0x00000007)

公众静态最终整数网络类型CDMA

已在中添加API级别4

当前网络为CDMA:IS95A或IS95B

常量值: 4(0x00000004)

公众静态最终整数网络类型_边缘

已在中添加API级别1

当前网络为EDGE

常量值: 2(0x00000002)

公众静态最终整数网络类型_EHRPD

已在中添加API级别11

当前网络为eHRPD

常量值: 14(0x0000000e)

公众静态最终整数网络类型_EVDO_0

已在中添加API级别4

当前网络为EVDO版本0

常量值: 5(0x00000005)

公众静态最终整数网络类型_EVDO_A

已在中添加API级别4

当前网络为EVDO版本A

常量值: 6(0x00000006)

公众静态最终整数网络类型_EVDO_B

已在中添加API级别9

当前网络为EVDO B版

常量值: 12(0x0000000c)

公众静态最终整数网络类型_GPRS

已在中添加API级别1

当前网络为GPRS

常量值: 1(0x00000001)

公众静态最终整数网络类型_HSDPA

已在中添加API级别5

当前网络为HSDPA

常量值: 8(0x00000008)

公众静态最终整数网络类型_HSPA

已在中添加API级别5

当前网络为HSPA

常量值: 10(0x0000000a)

公众静态最终整数网络类型_HSPAP

已在中添加API等级13

当前网络为HSPA+

常量值: 15(0x0000000f)

公众静态最终整数网络类型_HSUPA

已在中添加API级别5

当前网络为HSUPA

常量值: 9(0x00000009)

公众静态最终整数网络类型标识

已在中添加API级别8

当前网络是iDen

常量值: 11(0x0000000b)

公众静态最终整数网络类型_LTE

已在中添加API级别11

当前网络为LTE

常量值: 13(0x0000000d)

公众静态最终整数网络类型

已在中添加API级别1

当前网络为UMTS

常量值: (0x00000003)

公众静态最终整数网络类型未知

已在中添加API级别1

网络类型未知

常量值: 0(0x00000000)

公众静态最终整数电话_类型_CDMA

已在中添加API级别4

手机收音机是CDMA。

常量值: 2(0x00000002)

公众静态最终整数电话_类型_GSM

已在中添加API级别1

电话收音机是GSM。

常量值: 1(0x00000001)

公众静态最终整数电话_类型_无

已在中添加API级别1

没有电话收音机。

常量值: 0(0x00000000)

公众静态最终整数电话_类型_SIP

已在中添加API级别11

电话通过SIP。

常量值: (0x00000003)

公众静态最终整数SIM_状态_不存在

已在中添加API级别1

SIM卡状态:设备中没有可用的SIM卡

常量值: 1(0x00000001)

公众静态最终整数SIM_STATE_NETWORK_锁定

已在中添加API级别1

SIM卡状态:已锁定:需要网络PIN才能解锁

常量值: 4(0x00000004)

公众静态最终整数SIM_状态_PIN_必需

已在中添加API级别1

SIM卡状态:已锁定:需要用户的SIM PIN才能解锁

常量值: 2(0x00000002)

公众静态最终整数SIM_STATE_PUK_必需

已在中添加API级别1

SIM卡状态:已锁定:需要用户的SIM PUK才能解锁

常量值: (0x00000003)

公众静态最终整数SIM_状态_就绪

已在中添加API级别1

SIM卡状态:就绪

常量值: 5(0x00000005)

公众静态最终整数SIM_状态_未知

已在中添加API级别1

SIM卡状态:未知。表示SIM卡正在转换各州之间。例如,当用户输入SIM卡插针时在PIN_REQUIRED状态下,sim状态查询返回此状态,然后转到SIM_state_READY。

常量值: 0(0x00000000)

字段

公众静态最终的字符串 额外状态_怠速

与一起使用的值额外状态对应于呼叫_状态_空闲.

公众静态最终的字符串 额外_状态_关闭

与一起使用的值额外状态对应于呼叫状态挂起.

公众静态最终的字符串 超状态冷却

与一起使用的值额外状态对应于呼叫_状态_响铃.

公共方法

公众的列表<手机信息> 获取所有手机信息 ()

从上的所有无线电返回所有观察到的小区信息包括主单元和相邻单元的设备。这是真的不会导致或更改PhoneStateListner#onCellInfoChanged的速率。

该列表可以包括一个或多个手机信息Gsm,手机信息CDMA,Cell信息Lte手机信息CDMA任何组合。特别是在具有多个无线电的设备上,通常会看到列表中的一个或多个。此外,0、1或更多CellInfo对象可能返回isRegistered()true。

这比使用getCellLocation更好,尽管对于较老的设备,在这种情况下,getCellLocation应该被调用。

退换商品

公众整数 获取调用状态 ()

已在中添加API级别1

返回一个常数,指示设备上的通话状态(蜂窝)。

公众的单元格位置 获取单元格位置 ()

已在中添加API级别1

返回设备的当前位置。

如果设备中只有一个无线电,且该无线电具有LTE连接,此方法将返回null。实现不得尝试添加LTE标识符转换为现有的cdma/gsm类。

将来此调用将被弃用。

退换商品

公众整数 获取数据活动 ()

已在中添加API级别1

返回一个常量,该常量指示数据连接上的活动类型(手机)。

公众整数 获取数据状态 ()

已在中添加API级别1

返回指示当前数据连接状态的常量(手机)。

公众的字符串 获取设备ID ()

已在中添加API级别1

返回唯一的设备ID,例如GSM的IMEI和MEID或用于CDMA手机的ESN。如果设备ID不可用,则返回null。

需要权限:阅读_语音_状态

公众的字符串 获取设备软件版本 ()

已在中添加API级别1

返回设备的软件版本号,例如,GSM手机的IMEI/SV。如果软件版本为无法使用的。

需要权限:阅读_语音_状态

公众的字符串 获取组ID级别1 ()

已在中添加API等级18

返回GSM电话的组标识符级别1。如果不可用,则返回null。

需要权限:阅读_语音_状态

公众的字符串 获取行1编号 ()

已在中添加API级别1

返回第1行的电话号码字符串,例如MSISDN适用于GSM手机。如果不可用,则返回null。

需要权限:阅读_语音_状态

公众的字符串 获取MmsUAProfUrl ()

已在中添加API等级19

返回MMS用户代理配置文件URL。

公众的字符串 获取Mms用户代理 ()

已在中添加API等级19

返回MMS用户代理。

公众的列表<相邻单元格信息> 获取相邻单元格信息 ()

返回设备的相邻单元格信息。首选getAllCellInfo只有当getAllCellInfo返回null或空列表时才使用此选项。

将来此调用将被弃用。

退换商品
  • NeighboringCellInfo列表,如果信息不可用,则为null。

    需要权限:(@link android.Manifest.permission#ACCESS_COARSE_UPDATES}

公众的字符串 获取网络国家ISO ()

已在中添加API级别1

返回当前注册的ISO国家代码等效值操作员的MCC(移动国家代码)。

可用性:仅当用户注册到网络时。结果可能是在CDMA网络上不可靠(使用获取电话类型()以确定是否在CDMA网络上)。

公众的字符串 获取网络运营商 ()

已在中添加API级别1

返回当前注册运算符的数字名称(MCC+MNC)。

可用性:仅当用户注册到网络时。结果可能是在CDMA网络上不可靠(使用获取电话类型()以确定是否在CDMA网络上)。

公众的字符串 获取网络运营商名称 ()

已在中添加API级别1

返回当前注册运算符的字母名称。

可用性:仅当用户注册到网络时。结果可能是在CDMA网络上不可靠(使用获取电话类型()以确定是否在CDMA网络上)。

公众整数 获取网络类型 ()

已在中添加API级别1

退换商品
  • 当前数据连接的NETWORK_TYPE_xxxx。

公众整数 获取电话类型 ()

已在中添加API级别1

返回指示设备电话类型的常量。这个表示用于传输语音呼叫的无线电类型。

公众的字符串 获取模拟国家ISO ()

已在中添加API级别1

返回与SIM卡提供商的国家代码等效的ISO国家代码。

公众的字符串 getSim运算符 ()

已在中添加API级别1

返回的MCC+MNC(移动国家代码+移动网络代码)SIM卡的提供商。5或6位十进制数字。

可用性:SIM状态必须为SIM_状态_就绪

公众的字符串 获取Sim操作员名称 ()

已在中添加API级别1

返回服务提供商名称(SPN)。

可用性:SIM状态必须为SIM_状态_就绪

公众的字符串 获取SimSerialNumber ()

已在中添加API级别1

返回SIM卡的序列号(如果适用)。如果是,则返回null不可用的。

需要权限:阅读_语音_状态

公众整数 获取模拟状态 ()

已在中添加API级别1

公众的字符串 获取订阅服务器ID ()

已在中添加API级别1

返回唯一的用户ID,例如GSM电话的IMSI。如果不可用,则返回null。

需要权限:阅读_语音_状态

公众的字符串 获取语音邮件AlphaTag ()

已在中添加API级别1

检索与语音关联的字母标识符邮件号码。

需要权限:阅读_语音_状态

公众的字符串 获取语音邮件号码 ()

已在中添加API级别1

返回语音邮件号码。如果不可用,则返回null。

需要权限:阅读_语音_状态

公众布尔值 有IccCard ()

已在中添加API级别5

退换商品
  • 如果存在ICC卡,则为true

公众布尔值 isNetworkRoaming(isNetwork漫游) ()

已在中添加API级别1

如果设备被视为在当前网络,用于GSM目的。

可用性:仅当用户注册到网络时。

公众空隙 (电话状态侦听器侦听器,int事件)

已在中添加API级别1

注册侦听器对象以接收更改通知处于指定的电话状态。

要注册侦听器,请传递电话状态侦听器并指定至少一个感兴趣的电话状态events参数。注册时,以及指定的电话状态时更改时,电话管理器调用适当的侦听器对象上的回调方法并传递当前(udpated)值。

要注销侦听器,请传递侦听器对象并将事件参数到倾听_无(0).

参数
听众 这个电话状态侦听器要注册的对象(或未注册)
事件 侦听器感兴趣的电话状态,按位“或”组合电话状态侦听器倾听_标志。