【说明】 | rexseeIntent对象用于不同应用程序之间的互相调用,例如在本应用程序中调用其它应用程序并获得返回、向整个系统发送广播消息或者在其它应用程序调用自身时返回有用的数据。Intent机制是Android系统重要的互操作机制,请查看相关资料了解更多详细内容。 |
【函数】 | boolean isReady() |
【说明】 | 当前Intent是否就绪。 |
【返回】 | true或false。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.isReady());
运行示例
|
【函数】 | void create() |
【说明】 | 如果Intent不存在则创建。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 |
rexseeIntent.create();
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | void clear() |
【说明】 | 清除Intent。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 |
rexseeIntent.clear();
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | void reCreate() |
【说明】 | 清除Intent然后重新创建。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 |
rexseeIntent.reCreate();
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | void setAction(String action) |
【说明】 | 设置当前Intent的Action。 |
【返回】 | 无 |
【参数】 | action: Action字符串。 |
【示例】 |
rexseeIntent.setAction('android.intent.action.VIEW');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | String getAction() |
【说明】 | 读取当前Intent的Action。 |
【返回】 | Action字符串。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getAction());
运行示例
|
【函数】 | void setComponent(String packageName, String className) |
【说明】 | 设置当前Intent的目标应用软件及应用软件中的活动(类名)。 |
【返回】 | 无 |
【参数】 | packageName:目标应用软件的包名。 className:类名。 |
【示例】 |
rexseeIntent.setComponent('com.android.mms','com.android.mms.ui.ConversationList');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | String getPackageName() |
【说明】 | 读取当前Intent的目标应用程序的包名。 |
【返回】 | 包名。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getPackageName());
运行示例
|
【函数】 | String getClassName() |
【说明】 | 读取当前Intent的目标应用程序的活动(类名)。 |
【返回】 | 类名。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getClassName());
运行示例
|
【函数】 | String getShortClassName() |
【说明】 | 读取当前Intent的目标应用程序的活动(短类名)。 |
【返回】 | 短类名。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getShortClassName());
运行示例
|
【函数】 | void addCategory(String category) |
【说明】 | 向当前Intent中添加一个Category。 |
【返回】 | 无 |
【参数】 | category:Category名称。 |
【示例】 |
rexseeIntent.addCategory('android.intent.category.DEFAULT');
运行示例
rexseeIntent.addCategory('android.intent.category.OPENABLE'); rexseeDialog.toast('Finished.'); |
【函数】 | JsonArray getCategories() |
【说明】 | 读取当前Intent所有的Category。 |
【返回】 | 返回值是一个JSON格式的字符串,是一个数组,每个元素都是字符串,代表一个Category的名字,使用eval('('+json+')')将JSON字符串转换为JavaScript数组。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getCategories());
运行示例
|
【函数】 | void setDataAndType(String data) |
【函数】 | void setDataAndType(String data, String type) |
【说明】 | 设置当前Intent携带的数据和类型。 |
【返回】 | 无 |
【参数】 | data:Intent携带的数据,通常是URI。 type:数据的类型,例如"text/plain"、"image/*"等,如果缺省,系统会自动进行判断。 |
【示例】 |
rexseeIntent.setDataAndType('http://www.rexsee.com','text/html');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | void setData(String data) |
【说明】 | 设置当前Intent携带的数据。 |
【返回】 | 无 |
【参数】 | data:Intent携带的数据,通常是URI。 |
【示例】 |
rexseeIntent.setData('http://www.rexsee.com');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | String getData() |
【说明】 | 读取当前Intent携带的数据。 |
【返回】 | URI。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getData());
运行示例
|
【函数】 | void setType(String type) |
【说明】 | 设置当前Intent携带的数据的MIME类型。 |
【返回】 | 无 |
【参数】 | type:MIME类型。 |
【示例】 |
rexseeIntent.setType('text/plain');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | String getType() |
【说明】 | 读取当前Intent携带的数据的MIME类型。 |
【返回】 | MIME类型。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getType());
运行示例
|
【函数】 | void addFlag(String flag) |
【说明】 | 为当前Intent添加一个标志位。 |
【返回】 | 无 |
【参数】 | flag:标志位。 |
【示例】 |
rexseeIntent.addFlag('FLAG_ACTIVITY_NEW_TASK');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | int getFlags() |
【说明】 | 读取当前Intent所有的标志位进行或运算后得出的整形值,每个标志位实际上是int类型二进制流的一个字节,参见使用getFlag(flagName)函数可以读取某个Flag对应的字节。 |
【返回】 | 当前Intent所有的标志位进行或运算后得出的整形值。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getFlags());
运行示例
|
【函数】 | void putExtra(String key, String type, String value) |
【说明】 | 向当前Intent添加Extra。 |
【返回】 | 无 |
【参数】 |
key:该Extra的名称。
type:该Extra的类型,可能的类型包括:
value:该Extra的值,无论类型如何,都用字符串表示。 |
【示例】 |
rexseeIntent.putExtra('my.testExtra','int','65');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | String getExtra(String key, String type) |
【说明】 | 读取key指定的Extra的值,如果该值不存在,根据类型不同,会返回空、-1、false或null。 |
【返回】 | Extra的值,如果类型是数组,则返回Json数组,用eval('('+json+')')转换为JavaScript数组。 |
【参数】 | key:Extra的名称。 type:Extra的类型,参见putExtra()。 |
【示例】 |
alert(rexseeIntent.getExtra('my.testExtra','int'));
运行示例
|
【函数】 | JsonArray getExtras() |
【说明】 | 读取所有Extra的名称。 |
【返回】 | 所有Extra的名称,Json数组,用eval('('+json+')')转换为JavaScript数组。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getExtras());
运行示例
|
【函数】 | boolean hasExtra(String key) |
【说明】 | 判断key指定的Extra是否存在。 |
【返回】 | true或false。 |
【参数】 | key:Extra的名称。 |
【示例】 |
alert(rexseeIntent.hasExtra('my.testExtra'));
运行示例
|
【函数】 | boolean hasExtra() |
【说明】 | 判断是否存在Extra。 |
【返回】 | true或false。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.hasExtra());
运行示例
|
【函数】 | void removeExtra(String key) |
【说明】 | 删除key指定的Extra。 |
【返回】 | 无 |
【参数】 | key:Extra的名称。 |
【示例】 |
rexseeIntent.removeExtra('my.testExtra');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | void removeExtras() |
【说明】 | 删除所有Extra。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 |
rexseeIntent.removeExtras();
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | int getNumberOfExtras() |
【说明】 | 读取Extra的个数。 |
【返回】 | Extra的个数。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getNumberOfExtras());
运行示例
|
【函数】 | void start() |
【说明】 | 发送当前Intent。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 | 示例代码 运行示例 |
【函数】 | void chooseStart(String title) |
【说明】 | 和start()相同,不过如果存在多个应用程序满足Intent的条件,弹出一个对话框让用户选择调用哪个应用程序。 |
【返回】 | 无 |
【参数】 | title:对话框的标题。 |
【示例】 | 示例代码 运行示例 |
【函数】 | void startWithCallback() |
【说明】 | 发送当前Intent,所调用的应用程序返回后触发事件onIntentCallback,在该事件中可以用getData()、getExtra()等函数读取返回的数据。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 | 示例代码 事件代码 运行示例 |
【函数】 | void chooseStartWithCallback(String title) |
【说明】 | 和startWithCallback()相同,不过如果存在多个应用程序满足Intent的条件,弹出一个对话框让用户选择调用哪个应用程序。 |
【返回】 | 无 |
【参数】 | title:对话框的标题。 |
【示例】 | 示例代码 事件代码 运行示例 |
【函数】 | boolean copyInitIntent() |
【说明】 | 拷贝调用本程序的Intent,在使用getAction()、getData()等函数获取数据前,必须首先调用该函数。 |
【返回】 | true或false。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.copyInitIntent());
运行示例
|
【函数】 | void quit(boolean resultOK) |
【说明】 | 退出本应用程序,并将当前Intent返回给调用者,可以用setData()、putExtra()等函数传递数据。 |
【返回】 | 无 |
【参数】 | resultOK:true或false,表示所执行的任务是否成功。 |
【示例】 | 示例代码 运行示例 |
【函数】 | void broadcast() |
【说明】 | 广播当前Intent。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 | 示例代码 运行示例 |
【函数】 | void broadcast(String permission) |
【说明】 | 广播当前Intent,但只有具有permission指定的权限的应用程序才能接收。 |
【返回】 | 无 |
【参数】 | permission:权限名称,参见rexseeApplicationManager.getAllPermissionsByGroup()和rexseeApplicationManager.getAllPermissionGroupInfo(),另外,任意应用程序都可以自定义permission。 |
【示例】 | 无 |
【函数】 | void broadcastWithCallback(String permission) |
【说明】 | 和broadcast(String permission)相同,不过会在所有接收者接收并处理完毕后触发事件onIntentBroadcastCallback(),在事件中可以用getData()、getExtra()等函数读取返回的数据。 |
【返回】 | 无 |
【参数】 | permission:权限名称,参见rexseeApplicationManager.getAllPermissionsByGroup()和rexseeApplicationManager.getAllPermissionGroupInfo(),另外,任意应用程序都可以自定义permission。 |
【示例】 | 示例代码 事件代码 运行示例 |
【函数】 | boolean registerBroadcastReceiver(String action) |
【说明】 | 在系统中注册,开始监听某个广播Action,一旦接收到监听的Action,会触发事件onIntentBroadcastReceived()。 |
【返回】 | 之前已经注册返回false,否则进行注册并返回true。 |
【参数】 | action:广播Action的名称。 |
【示例】 |
alert(rexseeIntent.registerBroadcastReceiver('android.intent.action.SCREEN_OFF'));
事件代码
运行示例
|
【函数】 | boolean isRegisteredBroadcastReceiver(String action) |
【说明】 | 判断是否正在监听某个广播Action。 |
【返回】 | true或false。 |
【参数】 | action:Action的名称。 |
【示例】 |
alert(rexseeIntent.isRegisteredBroadcastReceiver('android.intent.action.SCREEN_OFF'));
运行示例
|
【函数】 | void unregisterBroadcastReceiver(String action) |
【说明】 | 在系统中取消注册,停止监听某个广播Action。 |
【返回】 | 无 |
【参数】 | action:广播Action的名称。 |
【示例】 |
rexseeIntent.unregisterBroadcastReceiver('android.intent.action.SCREEN_OFF');
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | void unregisterBroadcastReceiver() |
【说明】 | 在系统中取消所有已注册的监听器,停止监听所有广播Action。 |
【返回】 | 无 |
【参数】 | 无 |
【示例】 |
rexseeIntent.unregisterBroadcastReceiver();
运行示例
rexseeDialog.toast('Finished.'); |
【函数】 | int getNumberOfBroadcastReceivers() |
【说明】 | 读取正在监听的广播Action的个数。 |
【返回】 | 正在监听的广播Action的个数。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getNumberOfBroadcastReceivers());
运行示例
|
【函数】 | JsonArray getBroadcastReceivers() |
【说明】 | 读取正在监听的所有广播Action的列表。 |
【返回】 | 返回值是一个JSON格式的字符串,是一个数组,每个元素都是字符串,代表一个Action的名字,使用eval('('+json+')')将JSON字符串转换为JavaScript数组。 |
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getBroadcastReceivers());
运行示例
|
【函数】 | JsonArray getAllDefaultActions() |
【说明】 | 读取系统支持的所有默认的Action名称,但这并非应用程序可以使用的所有Action,很多应用程序具有自定义的Action可以供其它应用程序使用,同时,该函数返回的Action也并非都可以被应用程序发送,因为有一部分是只有系统程序才能使用系统广播Action,不过其中大部分虽然不可以发送却可以接收。 |
【返回】 |
返回值是一个JSON格式的字符串,是一个数组,每个元素都是字符串,代表一个Action的名字,使用eval('('+json+')')将JSON字符串转换为JavaScript数组。
视手机厂商和手机型号不同,该返回值可能有所不同。 Action分为两种,广播Action和互操作Action,广播Action用于发送或接收广播信息(通过registerBroadcastReceiver()函数设置接收),而互操作Action用于调用其它应用程序。下面是一些例子。 广播Action的例子:
|
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getAllDefaultActions());
运行示例
|
【函数】 | JsonArray getAllDefaultCategories() |
【说明】 | 读取系统支持的所有默认的Category名称。 |
【返回】 |
返回值是一个JSON格式的字符串,是一个数组,每个元素都是字符串,代表一个Category的名字,使用eval('('+json+')')将JSON字符串转换为JavaScript数组。
视手机厂商和手机型号不同,该返回值可能有所不同。下面是一些Category的例子:
|
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getAllDefaultCategories());
运行示例
|
【函数】 | JsonArray getAllDefaultExtras() |
【说明】 | 读取系统支持的所有默认的Extra名称,但这并非应用程序可以使用的所有Extra,应用程序可以使用任意自定义的Extra,当然Intent的目标程序必须具有相同的定义才能读取这些数据。 |
【返回】 |
返回值是一个JSON格式的字符串,是一个数组,每个元素都是字符串,代表一个Extra的名字,使用eval('('+json+')')将JSON字符串转换为JavaScript数组。
视手机厂商和手机型号不同,该返回值可能有所不同。下面是一些Extra的例子:
|
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getAllDefaultExtras());
运行示例
|
【函数】 | JsonArray getAllDefaultFlags() |
【说明】 | 读取系统支持的所有默认Flag名称。 |
【返回】 |
返回值是一个JSON格式的字符串,是一个数组,每个元素都是字符串,代表一个Flag的名字,每个Flag实际上对应了int类型整数二进制字节流中的一个字节,使用eval('('+json+')')将JSON字符串转换为JavaScript数组。
视手机厂商和手机型号不同,该返回值可能有所不同。以下是一些Flag的例子:
|
【参数】 | 无 |
【示例】 |
alert(rexseeIntent.getAllDefaultFlags());
运行示例
|
【函数】 | int getFlag(String name) |
【说明】 | 读取name对应的int类型数值,实际是二进制字节流中某一位为1,其它位为0,多个flag进行或操作得到系统最终使用的flag参数。 |
【返回】 | name对应的int类型数值。 |
【参数】 | name:flag的名称。 |
【示例】 |
alert(rexseeIntent.getFlag('FLAG_ACTIVITY_NEW_TASK'));
运行示例
|