【Android】Intent 中文API

 

Intent的中文意思是“意图，目的”的意思，可以理解为不同组件之间通信的“媒介”或者“信使”。

 

目标组件一般要通过Intent来声明自己的条件，一般通过组件中的<intent-filter>元素来过滤。

 

Intent在由以下几个部分组成：动作（action），数据（data），分类（Category），类型（Type），组件（Component），和扩展信息（Extra）。

 

Intent在寻找目标组件的时候有两种方法：第一，通过组件名称直接指定；第二，通过Intent Filter过滤指定

 

 

Intent启动不同组件的方法

组件名称	方法名称
Activity	startActivity() startActivityForResult()
Service	startService() bindService()
Broadcasts	sendBroadcast() sendOrderedBroadcast() sendStickyBroadcast()

 

 

常见的Activity Action Intent常量

常量名称	常量值	意义
ACTION_MAIN	android.intent.action.MAIN	应用程序入口
ACTION_VIEW	android.intent.action.VIEW	显示数据给用户
ACTION_ATTACH_DATA	android.intent.action.ATTACH_DATA	指明附加信息给其他地方的一些数据
ACTION_EDIT	android.intent.action.EDIT	显示可编辑的数据
ACTION_PICK	android.intent.action.PICK	选择数据
ACTION_CHOOSER	android.intent.action.CHOOSER	显示一个Activity选择器
ACTION_GET_CONTENT	android.intent.action.GET_CONTENT	获得内容
ACTION_DIAL	android.intent.action.GET_CONTENT	显示打电话面板
ACITON_CALL	android.intent.action.DIAL	直接打电话
ACTION_SEND	android.intent.action.SEND	直接发短信
ACTION_SENDTO	android.intent.action.SENDTO	选择发短信
ACTION_ANSWER	android.intent.action.ANSWER	应答电话
ACTION_INSERT	android.intent.action.INSERT	插入数据
ACTION_DELETE	android.intent.action.DELETE	删除数据
ACTION_RUN	android.intent.action.RUN	运行数据
ACTION_SYNC	android.intent.action.SYNC	同步数据
ACTION_PICK_ACTIVITY	android.intent.action.PICK_ACTIVITY	选择Activity
ACTION_SEARCH	android.intent.action.SEARCH	搜索
ACTION_WEB_SEARCH	android.intent.action.WEB_SEARCH	Web搜索
ACTION_FACTORY_TEST	android.intent.action.FACTORY_TEST	工厂测试入口点

 

常见的BroadcastIntent Action常量

BroadcastIntent Action字符串常量	描述
ACTION_TIME_TICK	系统时间每过一分钟发出的广播
ACTION_TIME_CHANGED	系统时间通过设置发生了变化
ACTION_TIMEZONE_CHANGED	时区改变
ACTION_BOOT_COMPLETED	系统启动完毕
ACTION_PACKAGE_ADDED	新的应用程序apk包安装完毕
ACTION_PACKAGE_CHANGED	现有应用程序apk包改变
ACTION_PACKAGE_REMOVED	现有应用程序apk包被删除
ACTION_UID_REMOVED	用户id被删除

 

Intent的Action和Data属性匹配

Action属性	Data属性	说明
ACTION_VIEW	content://contacts/people/1	显示id为1的联系人信息
ACTION_DIAL	content://contacts/people/1	将id为1的联系人电话号码显示在拨号界面中
ACITON_VIEW	tel:123	显示电话为123的联系人信息
ACTION_VIEW	http://www.google.com	在浏览器中浏览该网站
ACTION_VIEW	file://sdcard/mymusic.mp3	播放MP3
ACTION_VIEW	geo:39.2456,116.3523	显示地图

 

 

常见的Category常量

Category字符串常量	描述
CATEGORY_BROWSABLE	目标Activity能通过在网页浏览器中点击链接而激活（比如，点击浏览器中的图片链接）
CATEGORY_GADGET	表示目标Activity可以被内嵌到其他Activity当中
CATEGORY_HOME	目标Activity是HOMEActivity，即手机开机启动后显示的Activity，或按下HOME键后显示的Activity
CATEGORY_LAUNCHER	表示目标Activity是应用程序中最优先被执行的Activity
CATEGORY_PREFERENCE	表示目标Activity是一个偏爱设置的Activity

 

常见的Extra常量

Extra键值字符串常量	描述
EXTRA_BCC	装有邮件密送地址的字符串数组
EXTRA_CC	装有邮件抄送地址的字符串数组
EXTRA_EMAIL	装有邮件发送地址的字符串数组
EXTRA_INTENT	使用ACTION_PICK_ACTIVITY动作时装有Intent选项的键
EXTRA_KEY_EVENT	触发该Intent的案件的KeyEvent对象
EXTRA_PHONE_NUMBER	使用拨打电话相关的Action时，电话号码字符串的键，类型为String
EXTRA_SHORTCUT_ICON	使用ACTION_CREATE_SHORTCUT在HomeActivity创建快捷方式时，对快捷方式的描述信息。其中ICON和ICON_RESOURCE描述的是快捷方式的图标，类型分别为Bitmap和ShortcutIconResource。INTENT描述的是快捷方式相对应的Intent对象。NAME描述的是快捷方式的名字。
EXTRA_SHORTCUT_ICON_RESOURCE
EXTRA_SHORTCUT_INTENT
EXTRA_SHORTCUT_NAME
EXTRA_SUBJECT	描述信息主题的键
EXTRA_TEXT	使用ACTION_SEND动作时，用来描述要发送的文本信息，类型为CharSequence
EXTRA_TITLE	使用ACTION_CHOOSER动作时，描述对话框标题的键，类型为CharSequence
EXTRA_UID	使用ACTION_UID_REMOVED动作时，描述删除的用户id的键，类型为int

 

Android.telephony包中的类

类名	描述
CellLocation	表示设备位置的抽象类
PhoneNumberFormattingTextWather	监视一个TextView控件，如果有电话号码输入，则用formatNumber()方法处理电话号码
PhoneNumberUtils	包含各种处理电话号码字符串的使用工具
PhoneStateListener	监视手机中电话状态变化的监听类
ServiceState	包含电话状态和相关的服务信息
TelephonyManager	提供对手机中电话服务信息的访问

 

与短信服务相关的类主要在包android.telephony.gsm中

类名	描述
GsmCellLocation	表示GSM手机的基站位置
SmsManager	管理各种短信操作
SmsMessage	表示具体的短信

 

 

常用示例

 

显示网页:

Java代码

1. Uri uri = Uri.parse("http://www.google.com");  

2. Intent it = new Intent(Intent.ACTION_VIEW,uri);  

3. startActivity(it);  

显示地图:

Java代码

1. Uri uri = Uri.parse("geo:38.899533,-77.036476");  

2. Intent it = new Intent(Intent.Action_VIEW,uri);  

3. startActivity(it);  

路径规划:

Java代码

1. Uri uri = Uri.parse("http://maps.google.com/maps?f=d&saddr=startLat startLng&daddr=endLat endLng&hl=en");  

2. Intent it = new Intent(Intent.ACTION_VIEW,URI);  

3. startActivity(it);  

调用拨号程序：

Java代码

1. Uri uri = Uri.parse("tel:xxxxxx");  

2. Intent it = new Intent(Intent.ACTION_DIAL, uri);  

3. startActivity(it);  

拨打电话:

Java代码

1. Uri uri = Uri.parse("tel.xxxxxx");  

2. Intent it =new Intent(Intent.ACTION_CALL,uri);  

        要使用这个必须在配置文件中加入<uses-permission id="android.permission.CALL_PHONE" />

发送SMS/MMS
        调用发送短信的程序

Java代码

1. Intent it = new Intent(Intent.ACTION_VIEW);  

2. it.putExtra("sms_body", "The SMS text");  

3. it.setType("vnd.android-dir/mms-sms");  

4. startActivity(it);  

         发送短信

Java代码

1. Uri uri = Uri.parse("smsto:0800000123");  

2. Intent it = new Intent(Intent.ACTION_SENDTO, uri);  

3. it.putExtra("sms_body", "The SMS text");  

4. startActivity(it);  

        发送彩信

Java代码

1. Uri uri = Uri.parse("content://media/external/images/media/23");  

2. Intent it = new Intent(Intent.ACTION_SEND);  

3. it.putExtra("sms_body", "some text");  

4. it.putExtra(Intent.EXTRA_STREAM, uri);  

5. it.setType("image/png");  

6. startActivity(it);  

发送Email

Java代码

1. Uri uri = Uri.parse("mailto:[email protected]");  

2. Intent it = new Intent(Intent.ACTION_SENDTO, uri);  

3. startActivity(it);  

        或者：

Java代码

1. Intent it = new Intent(Intent.ACTION_SEND);  

2. it.putExtra(Intent.EXTRA_EMAIL, "[email protected]");  

3. it.putExtra(Intent.EXTRA_TEXT, "The email body text");  

4. it.setType("text/plain");  

5. startActivity(Intent.createChooser(it, "Choose Email Client"));  

        或者：

Java代码

1. Intent it=new Intent(Intent.ACTION_SEND);  

2. String[] tos={"[email protected]"};  

3. String[] ccs={"[email protected]"};  

4. it.putExtra(Intent.EXTRA_EMAIL, tos);  

5. it.putExtra(Intent.EXTRA_CC, ccs);  

6. it.putExtra(Intent.EXTRA_TEXT, "The email body text");  

7. it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");  

8. it.setType("message/rfc822");  

9. startActivity(Intent.createChooser(it, "Choose Email Client"));  

添加附件

Java代码

1. Intent it = new Intent(Intent.ACTION_SEND);  

2. it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");  

3. it.putExtra(Intent.EXTRA_STREAM, "file:///sdcard/mysong.mp3");  

4. sendIntent.setType("audio/mp3");  

5. startActivity(Intent.createChooser(it, "Choose Email Client"));  

播放多媒体

Java代码

1. Intent it = new Intent(Intent.ACTION_VIEW);  

2. Uri uri = Uri.parse("file:///sdcard/song.mp3");  

3. it.setDataAndType(uri, "audio/mp3");  

4. startActivity(it);  

        或者：

Java代码

1. Uri uri = Uri.withAppendedPath(MediaStore.Audio.Media.INTERNAL_CONTENT_URI, "1");  

2. Intent it = new Intent(Intent.ACTION_VIEW, uri);  

3. startActivity(it);  

卸载程序

Java代码

1. Uri uri = Uri.fromParts("package", strPackageName, null);  

2. Intent it = new Intent(Intent.ACTION_DELETE, uri);  

3. startActivity(it);  

安装程序

Java代码

1. Uri installUri = Uri.fromParts("package", "xxx", null);  

2. returnIt = new Intent(Intent.ACTION_PACKAGE_ADDED, installUri);  

搜索应用

Java代码

1. Uri uri = Uri.parse("market://search?q=pname:pkg_name");  

2. Intent it = new Intent(Intent.ACTION_VIEW, uri);  

3. startActivity(it);  

4. //where pkg_name is the full package path for an application