整理下 Intent 中文API 19

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:[e-mail]");  
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, "[e-mail]");  
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={"[e-mail]"};  
3. String[] ccs={"[e-mail]"};  
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