Intent机制 | 梧席

主要内容：Intent + Activity单/双向通信 + registerForActivityResult() + Notification通知

Intent概述

◼ Intent：是一种应用之间进行交互与通讯的机制

◼ Intent 负责对应用中的一个操作进行描述（描述包括动作、数据、接收组件等），Android 系统则根据这个描述，找到对应的组件，并将 Intent 传递给该组件，完成组件调用。

简言之：Intent 具有激活组件和携带数据的功能

◼ 例如：

Intent基本用例

启动三大组件：

◼ 启动Activity组件：
• startActivity(Intent intent);
• startActivityForResult(Intent intent,int requestCode);

◼ 启动Service组件:
• startService(Intent intent);
• bindService(Intent intent,ServiceConnection conn,int flags);

◼ 启动BroadcastReceiver组件:
• sendBroadcast(Intent intent);

本章准备：

◼ 新建 Module：IntentDemo

activity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="188dp"
        android:text="启动登录窗口"
        android:textSize="18sp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

MainActivity.java

public class MainActivity extends AppCompatActivity {
    Button btn;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        btn = findViewById(R.id.button);
        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
              //…
            }
        });
    }
}

◼ 新建LoginActivity

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".LoginActivity">
    <ImageView
        android:id="@+id/photo"
        android:layout_width="165dp"
        android:layout_height="177dp"
        android:layout_marginStart="16dp"
        android:layout_marginTop="32dp"
        android:layout_marginEnd="16dp"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:srcCompat="@drawable/login" />
    <TextView
        android:id="@+id/textView1"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="24dp"
        android:layout_marginTop="50dp"
        android:text="手机号"
        android:textSize="24sp"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/photo" />
    <EditText
        android:id="@+id/phone"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="12dp"
        android:ems="10"
        android:hint="11位手机号"
        android:inputType="phone"
        android:maxLength="11"
        android:textSize="24sp"
        app:layout_constraintBaseline_toBaselineOf="@+id/textView1"
        app:layout_constraintStart_toEndOf="@+id/textView1" />
    <TextView
        android:id="@+id/textView2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="24dp"
        android:layout_marginTop="25dp"
        android:text="密 码"
        android:textSize="24sp"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toBottomOf="@+id/textView1" />
    <EditText
        android:id="@+id/password"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginStart="12dp"
        android:ems="10"
        android:hint="不超过10个字符"
        android:inputType="textPassword"
        android:maxLength="10"
        android:textSize="24sp"
        app:layout_constraintBaseline_toBaselineOf="@+id/textView2"
        app:layout_constraintStart_toEndOf="@+id/textView2" />
    <Button
        android:id="@+id/login_btn"
        android:layout_width="379dp"
        android:layout_height="66dp"
        android:layout_marginStart="8dp"
        android:layout_marginEnd="8dp"
        android:layout_marginBottom="36dp"
        android:backgroundTint="@android:color/holo_green_light"
        android:text="登录"
        android:textSize="20sp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

LoginActivity的主题

◼ 在 themes.xml 中添加新主题：

<style name="Theme.Login" parent="Theme.MaterialComponents.DayNight.DarkActionBar">
  <!-- Primary brand color. -->
  <item name="colorPrimary">@android:color/holo_orange_dark</item>
  <item name="colorPrimaryVariant">@color/purple_700</item>
  <item name="colorOnPrimary">@color/white</item>
  <item name="android:statusBarColor" tools:targetApi="l">?attr/colorPrimaryVariant</item>
</style>

<style>：定义主题
Theme.Login：自定义主题名
parent：表示继承
DayNight.DarkActionBar：系统提供的主题
colorPrimary：主题色调
statusBarColor：状态条颜色(全屏将不显示)

LoginActivity的配置

◼ 在 AndroidManifest.xml 修改 LoginActivity 配置：

<activity
  android:name=".LoginActivity"
  android:exported="true"	<!--此项设置为true(默认为false)-->
  android:icon="@drawable/login"	<!--应用图标-->
  android:label="用户登录"	<!--ActionBar标题-->
  android:theme="@style/Theme.Login">	<!--给LoginActivity配置自定义主题-->
</activity>

LoginActivity.java

public class LoginActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_login);
        // 设置为全屏模式（隐藏状态条）
        getWindow().setFlags(
                WindowManager.LayoutParams.FLAG_FULLSCREEN,
                WindowManager.LayoutParams.FLAG_FULLSCREEN);
        // ActionBar显示返回按钮
        ActionBar actionBar = getSupportActionBar();
        actionBar.setDisplayHomeAsUpEnabled(true);

    }

    //3. 返回按钮的功能
    @Override
    public boolean onOptionsItemSelected(@NonNull MenuItem item) {
        switch (item.getItemId()) {
            case android.R.id.home:
                finish();
        }
        return false;
    }
}

Intent类型

显式Intent

◼ 显式 Intent：在 Intent 中明确指明要启动的组件类名。

◼ 以启动 Activity 为例：

显式 Intent 示例：

关键代码：

Button btn=findViewById(R.id.button);
btn.setOnClickListener(new View.OnClickListener() {
  @Override
  public void onClick(View v) {
    Intent intent = new Intent( MainActivity.this, LoginActivity.class );
    startActivity(intent);
  }
});

补充：了解一下

Intent intent = new Intent(MainActivity.this, LoginActivity.class);
⬇️等价写法：3 种
Intent intent = new Intent();
intent.setClass(MainActivity.this, LoginActivity.class);

Intent intent = new Intent();
intent.setClassName("com.example.intentdemo", "com.example.intentdemo.LoginActivity");	// 参数1：类所在的包名 参数2：类名(包含包名)


Intent intent = new Intent();
ComponentName component = new ComponentName("com.example.intentdemo", "com.example.intentdemo.LoginActivity");
intent.setComponent(component);

了解：Activity 启动和返回时堆栈变化：

隐式Intent

◼ 隐式 Intent：不明确指明要启动的组件类名，而由 Android 系统根据 Intent 描述的 action、data、 category 等信息进行组件匹配，由系统决定启动哪一个组件或弹出多个匹配组件的列表供用户选择。

◼ 例如：手机中有多个应用可以打开 pdf 文档，通过使用 Intent 隐式启动，由系统弹出一个应用选择对话框，由用户选取某个应用打开 pdf 文档。

隐式启动可以是：Android 系统内置组件，也可是程序本身组件，还可是第三方应用组件

示例1：

◼ 启动浏览器打开一个网站：

Uri webpage = Uri.parse("http://www.wust.edu.cn");
Intent intent = new Intent(); //创建intent
intent.setAction( Intent.ACTION_VIEW ); //设置intent动作	// Intent.ACTION_VIEW：表示一个查看动作(用于显示用户数据)
intent.setData( webpage ); //设置intent数据 (Uri对象)
startActivity(intent); //启动activity

◼ Uri 用来标识资源的逻辑位置(远程或本地)

◼ Uri.parse(串)：将uri格式串转换为Uri对象

说明：Intent.ACTION_VIEW 是一个字符串常量，值为”android.intent.action.VIEW”

其他写法：

◼ 写法1：
Intent intent = new Intent( Intent.ACTION_VIEW ); 
intent.setData( Uri.parse("http://www.163.com") );
◼ 写法2：
Intent intent = new Intent( Intent.ACTION_VIEW, Uri.parse("http://www.163.com") );

示例2：

◼ 打开拨号面板：

Intent intent = new Intent();
intent.setAction( Intent.ACTION_DIAL );
intent.setData( Uri.parse("tel:110") ); // 注："tel:"是电话模式(schema)
startActivity(intent);

Intent.ACTION_DIAL：表示打开拨号面板动作

示例3：

◼ 返回 Home 界面：

Intent intent = new Intent();
intent.setAction( Intent.ACTION_MAIN );
intent.addCategory( Intent.CATEGORY_HOME ); //设置action类别，本例必须
startActivity(intent);

Intent.ACTION_MAIN：表示程序入口
Intent.CATEGORY_HOME：这个类别是使 Intent 指向 Home 界面

示例4：

◼ 发送短信：

Intent intent = new Intent();
intent.setAction( Intent.ACTION_SENDTO );
intent.setData( Uri.parse("smsto:18908643860") ); //设置接收方	// 注："smsto:"是短信模式
intent.putExtra("sms_body", "hello"); //设置intent附加数据(扩展信息)	// Intent可以携带额外的 key-value 数据（此处key值是系统规定）
startActivity(intent);

Intent.ACTION_SENDTO：表示一个发送动作(明确接收方)，如：发送短信、彩信、图片、Email等

sms_body：key 值
“hello”：短信初始内容

示例5：

◼ 发送邮件：

Intent intent = new Intent();
intent.setAction( Intent.ACTION_SENDTO );
intent.setData( Uri.parse("mailto:zhangzhi@wust.edu.cn") ); //设置收件人	// 注："mailto:"是email模式
intent.putExtra( Intent.EXTRA_SUBJECT, "来自zz的问候" ); // Intent.EXTRA_SUBJECT是邮件主题
intent.putExtra( Intent.EXTRA_TEXT, "你好朋友..." ); // Intent.EXTRA_TEXT是邮件内容
startActivity(intent);

putExtra()方法的作用是添加附加数据

示例5：运行情况

说明：本例使用真机测试，手机中要安装好发邮件的 APP，例如：QQ 邮箱

示例6：

◼ 图片分享：

Intent intent = new Intent();
intent.setAction( Intent.ACTION_SEND );
//先将图片复制到相册（关键步骤）
Bitmap bitmap = BitmapFactory.decodeResource( getResources(), R.raw.gu );	// R.raw.gu 为 raw 文件夹中图片资源
Uri uri = Uri.parse(MediaStore.Images.Media.insertImage(getContentResolver(),bitmap,"hi",""));	// hi 为复制后的图片文件名
intent.setType("image/*"); //设置数据MIME类型
intent.putExtra( Intent.EXTRA_STREAM, uri ); // Intent.EXTRA_STREAM是附件信息，图片放在此处
startActivity(intent);

Intent.ACTION_SEND：表示一个发送动作，但未指定将数据交付给谁，会询问用户应该将数据发送到哪里

示例6：运行情况

说明：本例使用真机测试

注意：非空判断

◼ 当隐式 Intent 发出而找不到匹配 Activity 时，调用会失败，将导致应用崩溃。

◼ 安全起见，使用 intent.resolveActivity() 来判断一下：

Intent intent = new Intent();
…
// 判断是否存在匹配的 Activity
if ( intent.resolveActivity(getPackageManager()) != null ) { 
  startActivity(intent);
}

延迟Intent

◼ PendingIntent：延迟 Intent，它能授权其他应用以当前应用身份执行 Intent 操作。

◼ 特点：PendingIntent 是对 Intent 的一个封装，它不立刻执行该 Intent，而是在满足某些条件或触发某些事件后才执行(未来会进行的操作)。

◼ 应用场景：

PendingIntent 和 Intent 有什么区别

◼ 执行进程不同：Intent 通常在创建者进程中执行，PendingIntent 在其他进程执行；
◼ 执行时间不同：Intent 通常会立即执行，PendingIntent 会延迟执行；
◼ 执行身份不同：PendingIntent 支持授权，支持其他应用以当前应用的身份执行，Intent 一般只能以当前应用身份执行

PendingIntent的创建：3种类型

// 延迟启动 Activity
PendingIntent pendingIntent = PendingIntent.getActivity(Context context, int requestCode, Intent intent, int flags)
// 延迟启动 Service
PendingIntent pendingIntent = PendingIntent.getService(Context context, int requestCode, Intent intent, int flags)
// 延迟启动 BroadcastReceiver
PendingIntent pendingIntent = PendingIntent.getBroadcast(Context context, int requestCode, Intent intent, int flags)

PendingIntent标志位：

标志位取值	作用
FLAG_IMMUTABLE	不可变标志位，约束外部应用不能修改 Intent （常用）
FLAG_MUTABLE	可变标志位，外部应用可以修改 Intent
FLAG_ONE_SHOT	一次有效标记位，PendingIntent 只能使用一次（常用）
FLAG_UPDATE_CURRENT	更新标志位，如果系统中已经存在相同的 PendingIntent，那么将保留原有对象，而更新其中的 Intent
FLAG_CANCEL_CURRENT	更新标志位，如果系统中已经存在相同的 PendingIntent，那么将先取消原有的对象，并重新创建新的 PendingIntent
FLAG_NO_CREATE	更新标记位，如果系统中已经存在相同的 PendingIntent，那么不会重新创建，而是直接返回 null

示例：定时闹钟（定时启动LoginActivity）

如何创建闹钟：API 说明

1 2	// 调用系统服务创建闹钟： AlarmManager manager = (AlarmManager) getSystemService( ALARM_SERVICE );

getSystemService:获得系统服务

ALARM_SERVICE:闹钟服务（更多服务见后）

// 设置一次性任务的闹钟：
manager.set( int type, long triggerAtMillis, PendingIntent operation );	// 给闹钟添加PendingIntent，在闹钟定时结束时才执行
// 设置重复任务，时间固定的闹钟：
manager.setRepeating( int type, long triggerAtMillis, long intervalMillis, PendingIntent operation );
//取消闹钟：
manager.cancel(PendingIntent operation)

参数说明：
• int type：闹钟类型，例如：
① AlarmManager.RTC_WAKEUP：硬件时间(手机系统时间) ，当闹钟启动时会唤醒休眠设备
② AlarmManager.ELAPSED_REALTIME_WAKEUP：功能同上，时间是相对手机开机的时间
• long triggerAtMillis : 闹钟第一次执行时间(毫秒)
• long intervalMillis : 两次闹钟执行间隔(毫秒)
• PendingIntent operation : 延迟 Intent，任务的执行动作

Timer和AlarmManager主要区别

◼ 在 Android 系统中，Timer 不太适合那些需要长时间在后台运行的定时任务，因为 Android 设备有自己的休眠策略，当长时间的无操作，设备会自动让 CPU 进入休眠状态，这样就可能导致 Timer 中的定时任务无法正常运行。
◼ 而 AlarmManager 则不存在这种情况，因为它具有唤醒 CPU 的功能，可以保证每次需要执行特定任务时 CPU 都能正常工作。

闹钟代码：主体框架是TimePickerDialog

// 获得系统日期，用于设置TimePickerDialog的初始值
Calendar calender = Calendar.getInstance(); 
// 时间选择对话框
TimePickerDialog tpd = new TimePickerDialog(MainActivity.this, new TimePickerDialog.OnTimeSetListener() {
  @Override
  public void onTimeSet(TimePicker view, int hourOfDay, int minute) {
    // ① 创建Intent
    Intent intent = new Intent( MainActivity.this, LoginActivity.class ); 
    
    // ② 创建PendingIntent
    PendingIntent pendingIntent = PendingIntent.getActivity( MainActivity.this, 100, intent, PendingIntent.FLAG_IMMUTABLE);
    // 创建临时Calendar对象，目的：将设置的时:分转为毫秒数给闹钟设置定时时间
  	// 临时Calendar对象的值来自TimePickerDialog
    Calendar tmp = Calendar.getInstance();
    tmp.set(Calendar.HOUR_OF_DAY, hourOfDay); //设置时
    tmp.set(Calendar.MINUTE, minute); //设置分
    tmp.set(Calendar.SECOND, 0); //设置秒
    
    // ③ 创建闹钟（一次性任务）
    AlarmManager manager = (AlarmManager) getSystemService(ALARM_SERVICE);
    manager.set( AlarmManager.RTC_WAKEUP, tmp.getTimeInMillis(), pendingIntent );
    Toast.makeText(MainActivity.this, "闹钟设置成功", Toast.LENGTH_SHORT).show();
  } //end onTimeSet
}, calender.get(Calendar.HOUR_OF_DAY), calender.get(Calendar.MINUTE), true ); //end TimePickerDialog
tpd.show(); //显示日期选择对话框

Android系统服务列表：了解

服务名称	返回的对象	说明
WINDOW_SERVICE	WindowManager	管理打开的窗口程序
LAYOUT_INFLATER_SERVICE	LayoutInflater	取得xml里定义的view
ACTIVITY_SERVICE	ActivityManager	管理应用程序的系统状态
POWER_SERVICE	PowerManger	电源的服务
ALARM_SERVICE	AlarmManager	闹钟的服务
NOTIFICATION_SERVICE	NotificationManager	通知的服务
KEYGUARD_SERVICE	KeyguardManager	键盘锁的服务
LOCATION_SERVICE	LocationManager	位置的服务,如GPS
SEARCH_SERVICE	SearchManager	搜索的服务
VEBRATOR_SERVICE	Vebrator	手机震动的服务
CONNECTIVITY_SERVICE	Connectivity	网络连接的服务
WIFI_SERVICE	WifiManager	Wi-Fi服务
TELEPHONY_SERVICE	TeleponyManager	电话服务

Intent构成

◼ Intent 作为一个负责组件间传递信息的对象，最重要的就是其包含的信息。

◼ Intent 所包含的信息如下图所示：

Intent 的 7 个属性说明

属性	描述	操作方法示例
ComponentName	要启动的目标组件名称（显式Intent必须）	setComponent、setClass、setClassName等，较少使用
Action	指定Intent要执行的动作名 (注：一个Intent最多只能设置一个Action属性)	intent.setAction(action串) 注：多次设置会被覆盖（注：action 串可以是系统预定义的，也可是自定义的字符串）
Data	动作要操纵的数据（Uri对象）	intent.setData(Uri)
Type	指定数据的MIME类型(详见下页)	intent.setType(MIME串)、 intent.setDataAndType(Uri, MIME串)
Category	指定动作的类别（表示哪种类型的组件来处理这个Intent）（注：一个Intent可以包含多个Category属性）	intent.addCategory(category串) （注：category串可以是系统预定义的，也可是自定义的字符串）
Extra	指定附加扩展信息	putExtra(key, value)、putExtras(Bundle)
Flag	设置组件的运行模式	setFlags(flag串)、addFlags(flag串)

常见MIME类型：部分

MIME类型	描述
image/*	任意图片格式
video/*	任意视频格式
audio/*	任意音频格式
text/plain	txt 纯文本
application/msword	doc 格式文本
application/pdf	pdf 格式文本
application/zip	zip 压缩文件

更多MIME类型：https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types

Action动作：部分

Action名称	作用
Intent.ACTION_MAIN	表示程序入口值=”android.intent.action.MAIN”
Intent.ACTION_CALL	呼叫指定的电话号码（数据格式：”tel:手机号” ）值=”android.intent.action.CALL”
Intent.ACTION_DIAL	调用拨号面板（数据格式：”tel:手机号” ）值=”android.intent.action.DIAL”
Intent.ACTION_VIEW	用于显示用户的数据（经常使用）值=”android.intent.action.VIEW”
Intent.ACTION_PICK	打开资源选择器选择一个资源（图片、视频、文件、通讯录等）并返回它值=”android.intent.action.PICK”
Intent.ACTION_GET_CONTENT	同上，可多选，必须setType()数据类型值=”android.intent.action.GET_CONTENT”
Intent.ACTION_SENDTO	向数据指定的地方发送消息（如短信、彩信、Email）（短信：”smsto:手机号”，Email：”mailto:邮箱” ）
Intent.ACTION_SEND	发送信息，未指定将数据交付给谁，由动作接收方询问用户应该将数据发送到哪里，比如分享功能
Intent.ACTION_WEB_SEARCH	指定Web搜索（默认谷歌搜索），搜索数据：putExtra(SearchManager.QUERY, “searchString”)

更多Action用法参考：http://www.java2s.com/example/java-api/android/content/intent/index.html

Category类别：部分

Category类别	作用
Intent.CATEGORY_DEFAULT	把一个组件设为可被隐式启动，值=”android.intent.category.DEFAULT”
Intent.CATEGORY_LAUNCHER	把一个action设置为顶级启动器，值=”android.intent.category.LAUNCHER”
Intent.CATEGORY_BROWSABLE	当intent指向网络相关时，需要添加这个类别，值=”android.intent.category.BROWSABLE”
Intent.CATEGORY_HOME	使Intent指向Home界面，值=”android.intent.category.HOME”

Extra信息：部分

Extra串	作用
Intent.EXTRA_EMAIL	邮件接收方，值=”android.intent.extra.EMAIL”
Intent.EXTRA_SUBJECT	邮件主题，值=”android.intent.extra.SUBJECT”
Intent.EXTRA_TEXT	邮件内容，值=”android.intent.extra.TEXT”
Intent.EXTRA_STREAM	邮件附件，值=”android.intent.extra.STREAM”

Flag信息：

Extra串	作用
Intent.FLAG_ACTIVITY_CLEAR_TOP	相当于SingleTask
Intent.FLAGE_ACTIVITY_SINGLE_TOP	相当于SingleTop
Intent.FLAG_ACTIVITY_NEW_TASK	类似于SingleInstance
Intent.FLAG_ACTIVITY_NO_HISTORY	当离开该Activity后，该Activity将被从任务栈中移除
Intent.FLAG_GRANT_READ_URI_PERMISSION	授权组件有读取Intent中Uri数据的权限

Intent-Filter

隐式Intent启动过程

[1] Activity A 创建包含action操作、data数据等描述的 Intent，并将其传递给 startActivity(intent)

[2] Android 系统搜索所有应用中与 Intent 描述相匹配的组件，找到匹配项之后

[3] 调用匹配的 Activity B 并启动，并向其传递 Intent。

Intent-Filter

◼ intent-filter：intent过滤器，它是组件的一个配置，用于指定该组件要接受的 action(动作)、category(类别)和 data(数据或类型)。
◼ 一个组件可以存在多组 intent-filter。

Intent过滤器示例1：

AndroidManifest.xml

<activity android:name=".MainActivity" android:exported="true">
  <intent-filter>	<!--Intent过滤器配置-->
  <action android:name="android.intent.action.MAIN" />	<!-- 动作：表明此Activity是启动程序（程序入口）-->
  <category android:name="android.intent.category.LAUNCHER" />	<!-- 类别：表明把一个action设置为顶级启动器，此Activity将显示在程序列表里 -->
  </intent-filter>
</activity>

◼ <action> 声明接受的 Intent 操作（可以配置多个，可以是系统预定义的，也可以自定义）
◼ <category> 声明接受的 Intent 类别（可以配置多个，可以是系统预定义的，也可以自定义，隐式被启动的组件必须要配置 DEFAULT 类别）
◼ <data> 声明接受的数据或类型（数据是 Uri 格式，较少使用，数据类型是 MIME 类型）

注：如果必须确保只有自己的应用才能启动自己的某一组件，则不要给该组件声明 Intent 过滤器，同时设置该组件的 exported = “false”

Intent过滤器示例2：复杂一点

<activity android:name=".ShareActivity" android:exported="true">
  <!-- 该活动可以处理 SEND 这个 aciton，且处理的数据类型为 txt 格式文本 --> 
  <intent-filter> 
    <action android:name="android.intent.action.SEND"/> 
    <category android:name="android.intent.category.DEFAULT"/> <!-- 由于starActivity(intent) 默认会为Intent添加DEFAULT类别所以需要响应隐式Intent的Activity必须添加DEFAULT类别 -->
    <data android:mimeType="text/plain"/> <!-- 数据类型：text/plain表示txt格式文件 -->
  </intent-filter>
  <!-- 第二个过滤器，该活动可以处理 "SEND" 和 "SEND_MULTIPLE"这两种 aciton，且处理的数据格式为图片或视频 -->
  <intent-filter>
    <action android:name="android.intent.action.SEND"/>
    <action android:name="android.intent.action.SEND_MULTIPLE"/> <!-- 注：Intent 只能有1个 action，而 Intent 过滤器可有多个 action -->
    <category android:name="android.intent.category.DEFAULT"/>
    <data android:mimeType="image/*"/>
    <data android:mimeType="video/*"/>	<!-- 数据类型：image/*表示所有图片格式，video/*表示所有视频格式 -->
  </intent-filter>
</activity>

隐式Intent匹配规则

◼ 当 Android 系统收到隐式 Intent 时，会与设备上所有应用组件的 Intent 过滤器进行比对；
◼ 一个组件如有多个 Intent 过滤器，则只需与其中任何一个匹配即可启动组件；
◼ 系统会根据 Intent 信息与 Intent 过滤器的 action、data、category 进行比对，要全部通过才能匹配；
◼ 匹配原则：category 必须全匹配， action 和 data 只需配一个（部分匹配）
◼ 如果 Intent 与 Intent 过滤器匹配，则系统将启动该组件，并向其传递 Intent 对象，如果有多个 Intent 过滤器匹配，则系统会显示一个对话框，由用户选取要使用的应用。

action匹配规则
◼ Intent 只能包含一项 action，而 Intent 过滤器可以包含多项 action，只要 Intent 的 action 可以在 Intent 过滤器中找到对应项即可通过匹配。
◼ 当 Intent 过滤器未声明任何 action 时，任何 Intent 都不能通过匹配。
◼ 当 Intent 未指定 Action 时，无法通过匹配。

category匹配规则
◼ Intent 可以包含多项 category，Intent 过滤器也可以包含多项 category。Intent 中的每项 category 必须在 Intent过滤器中都有对应项，才能通过匹配。
◼ 当目标组件为 Activity 时，如需响应隐式 Intent，必须添加 “android.intent.category.DEFAULT” 到 Intent 过滤器中。因为启动 Activity 的方法都会默认为 Intent 添加该 category。
◼ 目标组件为广播时，Intent 和 Intent 过滤器都不设置 category，可通过匹配。

data匹配规则

◼ data 具有子元素，如下图，Uri 匹配较少使用，略。

一个完整的 data 示例： <data android:scheme=”https” android:host=”www.abc.com“ android:port=”80” android:path=”/folder/subfolder/etc”/>

Uri 要完全匹配它的话则为：Uri uri = Uri.parse(“https://www.abc.com:80/folder/subfolder/etc“);

练习：隐式启动LoginActivity

◼ 想使用隐式Intent启动 LoginActivity，语句如下：

1 2	Intent intent = new Intent( Intent.ACTION_VIEW ); startActivity(intent);

◼ 如何配置 LoginActivity？

参考答案：

◼ 首先给 LoginActivity 配置 Intent 过滤器：

AndroidManifest.xml

<activity android:name=".LoginActivity"
  android:label="用户登录"
  android:exported="true">
  <intent-filter>	<!-- 配置Intent过滤器 -->
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />	<!-- 隐式需要将category设置为DEFAULT -->
  </intent-filter>
</activity>

运行情况：

强制使用应用选择器

◼ 始终使用选择器对话框，避免”always”操作后无法选择

1
2
3

Intent intent = new Intent( Intent.ACTION_VIEW );
Intent chooser = Intent.createChooser(intent, "标题"); //强制弹出选择器
startActivity(chooser);

Intent传递数据

单向传值

◼ 常使用 Bundle 传递数据：

A端

Intent intent = new Intent( A.this, B.class );
Bundle bundle = new Bundle();
bundle.putString(key, value); //key-value键值对，假设value是String类型
intent.putExtras(bundle); //为intent设置bundle
startActivity(intent); //启动B

B端

1
2
3

Intent intent = getIntent(); //获取A传递过来的intent
Bundle bundle = intent.getExtras(); //取出intent中的bundle
String name = bundle.getString(key); //根据key获取value

关于 Bundle

◼ Bundle 是一个存储 key-value 键值对的集合类，多应用于 Activity 之间相互传递值。

其他方法如：putInt()/getInt()、putDouble()/getDouble() putChar()/getChar() 、putIntArray()/getIntArray() putSerializable()/getSerializable() 等

Bundle一些其他方法

◼ clear()：清除所有数据
◼ remove(String key)：移除指定key的值
◼ clone()：克隆当前Bundle
◼ isEmpty()：判断是否为空
◼ containsKey(String key)：是否包含指定的key
◼ keySet()：获得所有key值集合

单向传递数据示例

发送端：LoginActivity 主要代码

// 获取输入数据
String s_phone = ((EditText)findViewById(R.id.phone)).getText().toString();
String s_password = ((EditText)findViewById(R.id.password)).getText().toString();

// 准备数据 (bundle)
Intent intent = new Intent( LoginActivity.this, WelcomeActivity.class );
Bundle bundle = new Bundle();
bundle.putString( "phone" , s_phone);
bundle.putString( "password" , s_password);
intent.putExtras(bundle);
startActivity(intent); //启动

接收端：WelcomeActivity 主要代码

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_welcome);
  Intent intent = getIntent();
  Bundle bundle = intent.getExtras();
  String phone = bundle.getString("phone");
  String password = bundle.getString("password");
  Snackbar.make( findViewById(R.id.contraintLayout), 
    "登录成功, phone=" + phone, Snackbar.LENGTH_SHORT)
    .show();
}

双向传值

双向传值流程：

核心代码框架：A端为发送端，B端为接收端

A端

1
2
3

Intent intent = new Intent( A.this, B.class );
// 准备Bundle数据放入intent (略)
startActivityForResult( intent, 100 ); 	// 100是请求码(requestCode)，主要用于标识请求来源

B端

Intent intent = getIntent(); //取得A传过来的Intent
// 从intent中获取Bundle数据进行处理，将回传的数据放入intent (略)
setResult( RESULT_OK, intent );
//关闭B，返回A
finish();

RESULT_OK:这个参数称为结果码(resultCode) 用于标识结果的状态，常见取值：
• RESULT_OK (值=-1)
• RESULT_CANCELED (值=0) • 或自拟大于0整数

A端 onActivityResult 回调函数

@Override
protected void onActivityResult( int requestCode, int resultCode, Intent data ) {	// data: B回传的Intent
  super.onActivityResult(requestCode, resultCode, data);
  if( requestCode == 100 ) { // 表明是A→B的请求,如有多个请求码建议用switch
    if ( resultCode == RESULT_OK ) {	// B回传的结果状态
      //处理B回传的数据
      Bundle bundle = data.getExtras(); 
      …
    }
  }
}

示例1：登录信息回传

发送端：LoginActivity主要代码

// 获取输入数据
String s_phone = ((EditText)findViewById(R.id.phone)).getText().toString();
String s_password = ((EditText)findViewById(R.id.password)).getText().toString();

// 准备数据 (bundle)
Intent intent = new Intent( LoginActivity.this, WelcomeActivity.class );
Bundle bundle = new Bundle();
bundle.putString( "phone" , s_phone);
bundle.putString( "password" , s_password);
intent.putExtras(bundle);
// 数据获取和准备代码没有变化

startActivityForResult(intent, 100);	// 100为requestCode值
// 此处改用startActivityForResult()

接收端：WelcomeActivity主要代码

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_welcome);
  
  Intent intent = getIntent();
  Bundle bundle = intent.getExtras();
  // 处理提交的数据
  String phone = bundle.getString("phone").substring(0,3);
  String password = bundle.getString("password").toUpperCase();
  bundle.putString( "info", phone + password );
  intent.putExtras(bundle);
  // 关键代码：回传并结束
  setResult( RESULT_OK, intent );
  finish(); 
}

发送端：LoginActivity的回调函数

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == 100)
        if (resultCode == RESULT_OK) {
            Bundle bundle = data.getExtras();
            String info = bundle.getString("info");
            //使用Snackbar显示info
            Snackbar snackbar = Snackbar.make( findViewById(R.id.login_btn), "回传信息=" + info,Snackbar.LENGTH_INDEFINITE );
            snackbar.setAction("确定", new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    snackbar.dismiss(); //手工清除Snackbar
                }
            });
            snackbar.show();
        }
}

示例2：相册选取图片显示

上传图片到模拟器方法：模拟器要处于启动状态

LoginActivity关键代码

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_login);
    …
    photo = (ImageView) findViewById(R.id.photo);	// 先定义一个类成员变量：private ImageView photo;
    photo.setOnClickListener(new View.OnClickListener() {	// 图片框添加单击事件
        @Override
        public void onClick(View v) {
            Intent intent = new Intent( Intent.ACTION_PICK );	// Intent.ACTION_PICK：表示选择动作，隐式Intent
            intent.setData( MediaStore.Images.Media.EXTERNAL_CONTENT_URI );	// 系统提供的相册数据集Uri
            intent.setType("image/*");	// MIME为图片类型
            startActivityForResult(intent, 200);
        }
    });
}

LoginActivity回调函数

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    if (requestCode == 200)
        if (resultCode == RESULT_OK) {
            photo.setImageURI( data.getData() );	// 从Intent中获取返回照片的Uri值
        }
}

获取图片的另一种方法：

1 2	Intent intent = new Intent( Intent.ACTION_GET_CONTENT ); intent.setType("image/*"); //必须写

ACTION_PICK 和 ACTION_GET_CONTENT 区别：
◼ 均能打开资源选择器选择资源（图片、视频、文件、通讯录等）并返回
◼ ACTION_PICK 只能选择一个项目（不支持多选），常配合 ContentProvider 使用，返回的 Uri 格式只有一种， setType() 非必须
◼ ACTION_GET_CONTENT 支持多选，返回的 Uri 格式有多种，必须设置用 setType() 数据类型

注册方式（新API）

registerForActivityResult()

◼ 随着应用扩展，onActivityResult() 回调方法各种嵌套、耦合严重、难以维护
◼ registerForActivityResult() 是 startActivityForResult() + onActivityResult() 的替代，是一种全新的 Activity Results API，它简化了数据回调的写法（强烈推荐）

registerForActivityResult方法3个主要部件

1	ActivityResultLauncher registerForActivityResult(ActivityResultContract, ActivityResultCallback)

部件组成图示：

代码框架：

// ① 创建启动器
ActivityResultLauncher launcher = registerForActivityResult( 	// ① 定义启动器对象（类成员变量）
    new ActivityResultContracts.协议() , // 参数1：新建协议类实现对象 (系统提供的实现类详见下图)
    new ActivityResultCallback<返回类型O>() {	// 参数2：匿名实现回调接口，返回类型根据协议不同有所不同，详见下图
        @Override
        public void onActivityResult(返回类型O result) {
            // 处理返回的result数据
        }
    }
);

// ② 启动器使用launch方法启动Activity
launcher.launch(参数); // 启动参数可能是Intent、Uri、MIME串等，详见下图

部分协议实现类和启动参数：编程重点参考

ActivityResultContracts.*	说明	launch的启动参数	回调返回的类型
StartActivityForResult	普通的StartActivityForResult（传统的Activity跳转）	Intent	ActivityResult
RequestPermission	单个权限请求	Manifest.permission.*	是否授予该权限
RequestMultiplePermissions	多个权限请求	Array<Manifest.permission.*>	map类型(key为请求的权限， value为是否授予
TakePicture	通过MediaStore.ACTION_IMAGE_CAPTURE 拍照并保存	保存文件的Uri	是否保存成功
TakePicturePreview	通过MediaStore.ACTION_IMAGE_CAPTURE 拍照并预览	null	图片的Bitmap
TakeVideo	通过MediaStore.ACTION_VIDEO_CAPTURE 拍照并保存	保存文件的Uri	视频的缩略图Bitmap
PickContact	通过Intent.ACTION_PICK选择联系人	null	联系人Uri
GetContent	通过Intent.ACTION_GET_CONTENT获取一个文件	MIME类型	文件Uri

注册方式示例

示例1：登录信息回传

示例1：登录信息回传 (改写双向传递数据示例1，实现传统的Activity跳转)

◼ 主要变动：
◼ 只修改发送端LoginActivity代码，3处：
（1）创建启动器（一般作为类成员变量)
（2）用启动器的launch()方法替换startActivityForResult()
（3）去掉onActivityResult()回调
◼ 接收端WelcomeActivity代码没有变动

发送端：LoginActivity主要代码

// ① 创建启动器成员变量
ActivityResultLauncher launcher1 = registerForActivityResult(
    new ActivityResultContracts.StartActivityForResult(),	// 协议使用StartActivityForResult实现
    new ActivityResultCallback<ActivityResult>() {	// 该协议返回的类型是ActivityResult
        @Override
        public void onActivityResult(ActivityResult result) {
            int resultCode = result.getResultCode(); //获取返回的resultCode
            if (resultCode == RESULT_OK) {
                Intent data = result.getData(); //获取返回的intent
                Bundle bundle = data.getExtras();
                // …其他代码不变
            }
        }
    } );

// 获取输入数据
String s_phone = ((EditText)findViewById(R.id.phone)).getText().toString();
String s_password = ((EditText)findViewById(R.id.password)).getText().toString();

// 传递数据
Intent intent = new Intent( LoginActivity.this, WelcomeActivity.class );
Bundle bundle = new Bundle();
bundle.putString( "phone" , s_phone);
bundle.putString( "password" , s_password);
intent.putExtras(bundle);
// startActivityForResult(intent, 100); 
launcher1.launch(intent); //参数为intent
// ② 此处改用启动器启动Activity

@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    // ③ 注释或删除原来代码，或删除整个onActivityResult回调函数
    /*
    if (requestCode == 100)
        if (resultCode == RESULT_OK) {
            Bundle bundle = data.getExtras();
            String info = bundle.getString("info");
            //使用Snackbar显示info）
        }
    */
    // … 其他回传
}

示例2：手机相册选取图片显示

(改写双向传递数据例2)

// 1. 创建启动器成员变量
ActivityResultLauncher launcher2 = registerForActivityResult(
            new ActivityResultContracts.GetContent(),	// 协议使用GetContent实现
            new ActivityResultCallback<Uri>() {	// 该协议对应返回的回调类型是Uri
                @Override
                public void onActivityResult(Uri result) {
                    photo.setImageURI(result);
                }
            });
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_login);
    // …
    photo = (ImageView) findViewById(R.id.photo);
    photo.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            launcher2.launch("image/*");	// 2. 启动，需添加MIME类型参数，不需要创建隐式Intent，代码更简洁了
            // 注：这个获取的是所有本地图片，而不只是系统相册
        }
    });
}
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
    super.onActivityResult(requestCode, resultCode, data);
    // 不需要了，或删除整个onActivityResult()回调函数
    /*
    if (requestCode == 200)
        if (resultCode == RESULT_OK) {
        photo.setImageURI( data.getData() );
        }
    */
    // … 其他回传
}

示例3：打开相机拍照并显示

ActivityResultLauncher launcher3 = registerForActivityResult(
        new ActivityResultContracts.TakePicturePreview(),
        new ActivityResultCallback<Bitmap>() {
            @Override
            public void onActivityResult(Bitmap result) {
//result为拍摄照片Bitmap格式
                photo.setImageBitmap(result);
            }
        });

// 启动代码：
launcher3.launch( null );	// 启动参数用null，不要不写

示例4：选择视频播放

◼ 新建：VideoPlayActivity

VideoPlayActivity配置：

<activity
    android:name=".VideoPlayActivity"
    <!-- 默认情况，每次屏幕切换时会重启Activity（回顾一下生命周期测试情况）添加configChanges配置可以阻止重启，避免重启导致视频播放对话框被摧毁 -->
    android:configChanges="orientation|screenSize"	<!-- 此处有2个值 -->
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

了解：android:configChanges 部分取值

值	作用
locale	设备的本地位置发生了改变，一般指的是切换了系统语言
keyboardHidden	键盘的可访问性发生了改变，比如用户调出了键盘
fontScale	系统字体缩放比例发生了改变，比如用户选择了个新的字号
uiMode	用户界面模式发生了改变，比如开启夜间模式
orientation	屏幕方向发生改变，比如旋转了手机屏幕
screenSize	当屏幕尺寸信息发生改变

说明：如果 activity 没有配置 android:ConfigChanges，此时默认让系统处理，当旋转屏幕时，会重建 Activity，此时 Activity 按生命周期走一遍。如果配置了该属性，当指定的配置发生改变的时候，系统将不会重启 activity，而是执行 onConfigurationChanged() 函数，这样就可以让我们自己处理横屏这件事

Activity_video_play.xml

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".VideoPlayActivity">
<Button
    android:id="@+id/btn_open"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="32dp"
    android:text="打开视频"
    android:textSize="18sp"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

VideoPlayActivity.java

public class VideoPlayActivity extends AppCompatActivity {
    ExoPlayer player; // 播放器（播放视频）
    StyledPlayerView playerView; // 播放器视图（里面存放播放器）
    Dialog dialog; // 对话框（里面存放播放器视图）
    ActivityResultLauncher launcher4 = registerForActivityResult(
            new ActivityResultContracts.GetContent(),
            new ActivityResultCallback<Uri>() {
                @Override
                public void onActivityResult(Uri result) {
                    playVideo(result); //播放视频见后
                }
            });
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_video_play);
        Button btn = findViewById(R.id.btn_open);
        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                if ( player != null && player.isPlaying() ) {
                    player.stop(); //如果视频已在播放则停止播放，重新选择视频加载
                }
                launcher4.launch("video/*"); //MIME是视频类型
            }
        });
    }

    //播放视频
    public void playVideo(Uri uri) {
        playerView = new StyledPlayerView(this); //创建播放器视图
//创建播放器
        player = new ExoPlayer.Builder(VideoPlayActivity.this).build();
        player.setMediaItem( MediaItem.fromUri( uri ) ); //添加视频资源
        playerView.setPlayer(player); //将player加载到播放器视图中
//创建全屏对话框
        dialog = new Dialog(VideoPlayActivity.this,
                android.R.style.Theme_Black_NoTitleBar_Fullscreen);
        dialog.setContentView(playerView); //窗口加载播放器视图
//监听对话框关闭
        dialog.setOnDismissListener(new DialogInterface.OnDismissListener() {
            @Override
            public void onDismiss(DialogInterface dialog) {
                player.stop(); //停止播放
                player.release(); //回收播放器
            }
        });
        dialog.show(); //显示对话框窗口
        player.prepare(); //准备播放
        player.play(); //播放
    }
} //end activity

示例5：权限申请（重要）

◼ Android 权限有助于保护用户隐私。
◼ 如要访问用户敏感数据（如联系人或短信）或某些系统功能（如定位或互联网访问），则应用必须请求相关权限，得到用户授权的数据或功能才能执行。
◼ Android 每个权限均由一个唯一字符串标识：
例如，读取联系人权限：”android.permission.READ_CONTACTS”

首先声明应用权限：

◼ 在 AndroidManifest.xml 配置文件中申请相关权限：以读取联系人为例

1	<uses-permission android:name="android.permission.READ_CONTACTS" />

然后请求权限：

//① 创建权限申请的启动器
private final ActivityResultLauncher permissionLauncher = registerForActivityResult(
        new ActivityResultContracts.RequestPermission(),
        new ActivityResultCallback<Boolean>() {
            @Override
            public void onActivityResult( Boolean result ) {	// true表示申请成功
                if ( result ) {
                    Toast.makeText(MainActivity.this, "申请权限通过", Toast.LENGTH_SHORT).show();
                    // 业务处理…
                } else {
                    // 权限被拒绝，可在系统设置中手工开启权限
                }
            }
        }
);
//② 在需要的时候启动权限请求（封装一下）
private void requestPermission() {
    permissionLauncher.launch(Manifest.permission.READ_CONTACTS);	// 参数是要申请的某个权限标识串
    // 值="android.permission.READ_CONTACTS"
}

补充：多个权限请求

先声明，以读取图片、视频权限为例：
<uses-permission android:name=”android.permission.READ_MEDIA_IMAGES” />
<uses-permission android:name=”android.permission.READ_MEDIA_VIDEO” />

java
//① 多权限申请
private final ActivityResultLauncher permissionLauncher2 = registerForActivityResult(
        new ActivityResultContracts.RequestMultiplePermissions(),
        new ActivityResultCallback<Map<String, Boolean>>() {	// 返回值为Map，键值对为：<权限名，是否申请成功>
            @Override
            public void onActivityResult( Map<String, Boolean> result ) {
                if (result.get(Manifest.permission.READ_MEDIA_IMAGES) != null && result.get(Manifest.permission.READ_MEDIA_VIDEO) != null) {
                    if (Objects.requireNonNull(result.get(Manifest.permission.READ_MEDIA_IMAGES)).equals(true)
                            && Objects.requireNonNull(result.get(Manifest.permission.READ_MEDIA_VIDEO)).equals(true)) {
                        //权限全部获取到之后的动作
                    } else {
                        //有权限没有获取到的动作
                    }
                }
            }
        }
);
//② 在需要的时候启动权限请求（封装一下）
private void requestPermission2() {
//权限数组
    String[] permissions = new String[] { Manifest.permission.READ_MEDIA_IMAGES, Manifest.permission.READ_MEDIA_VIDEO };
    permissionLauncher.launch2( permissions );
}

第三方权限框架：Permissionx

◼ 下载依赖库：com.permissionx.guolindev:permissionx

多个权限请求：实现更简洁

PermissionX.init(MainActivity.this)
        .permissions( Manifest.permission.READ_MEDIA_IMAGES, Manifest.permission.READ_MEDIA_VIDEO )	// 权限列表
        .request( new RequestCallback() {
            @Override
            public void onResult( boolean allGranted, @NonNull List<String> grantedList, @NonNull List<String> deniedList ) {
                if( allGranted ) {
                    Toast.makeText(MainActivity.this, "所有申请的权限都已通过", Toast.LENGTH_SHORT).show();
                }else{
                    Toast.makeText(MainActivity.this, "您拒绝了部分权限", Toast.LENGTH_SHORT).show();
                }
            }
});

Notification编程

◼ Notification：是一种具有全局效果的通知，可以在系统的通知栏中显示。
◼ 当 APP 向系统发出通知时，它将先以图标的形式显示在通知栏中，用户可以下拉通知栏查看通知的详细信息。
◼ 通知常见的用途：
◼ 显示接收到短消息、即时消息等信息
◼ 显示客户端的推送消息
◼ 显示正在进行的应用（用户可以交互）

通知权限

从 Android13 开始发送通知需要权限

◼ 先在AndroidManifest.xml配置文件中添加权限：

1	<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

然后请求权限：

//① 创建权限申请的启动器
private final ActivityResultLauncher permissionLauncher = registerForActivityResult(
        new ActivityResultContracts.RequestPermission(),
        new ActivityResultCallback<Boolean>() {
            @Override
            public void onActivityResult( Boolean result ) {	// true表示申请成功
                if ( result ) {
                    // 业务处理…
                }
            }
        }
);
//② 在需要的时候启动权限请求（封装一下）
private void requestPermission() {
    permissionLauncher.launch( Manifest.permission.POST_NOTIFICATIONS );	// 参数是要申请的某个权限，如发送通知权限
}

通知编程

通知编程相关类
◼ Notification 类：通知类，保存通知相关数据
◼ NotificationManager 类：通知管理类，负责发送通知 notify() 、清除通知 cancel() 等操作
◼ NotificationChannel：通知渠道，可以统一设置其中所有通知的视觉和听觉行为，如通知级别、声音、指示灯颜色等
◼ PendingIntent：延迟 Intent 类，委托授权延迟操作

通知编程的核心代码：

//① 相关成员定义
private static final int NOTIFY_ID = 1; //通知的id (自拟)
private static final String CHANNEL_ID = "123"; //通知渠道的id (自拟)
private static final String CHANNEL_Name = "mychannel"; //通知渠道的名称(自拟)
NotificationManager manager; //通知管理类
Notification notification; //通知类
NotificationChannel channel; //通知渠道
PendingIntent pendingIntent; //延迟Intent
Bitmap bitmap; //通知的LargeIcon

// ② 创建通知管理器
manager = (NotificationManager) getSystemService( NOTIFICATION_SERVICE );
// getSystemService:获得系统服务
// NOTIFICATION_SERVICE:通知服务


// ③ 创建通知渠道
channel = new NotificationChannel( CHANNEL_ID,	// 通知渠道id
    CHANNEL_Name,	// 渠道名称
    NotificationManager.IMPORTANCE_HIGH );	// 通知的优先级：HIGH是最高级(通知有声音提醒+弹出显示)
manager.createNotificationChannel(channel);

// ④ 创建PendingIntent
Intent intent = new Intent( 当前Activity.this, 通知要启动的Activity.class);	// 普通的 intent，将用 PendingIntent 封装为延迟 intent
pendingIntent = PendingIntent.getActivity( 当前Activity.this, 0, intent, PendingIntent.FLAG_IMMUTABLE );
// 当前Activity.this：上下文
// 0:requestCode（自拟）
// PendingIntent.FLAG_IMMUTABLE：标志位，FLAG_IMMUTABLE：表示构建无法被修改的PendingIntent常用于由于明确知道未来需要进行的操作

// ⑤ 创建大图标的Bitmap （raw资源转Bitmap）
bitmap = BitmapFactory.decodeResource( getResources(), R.drawable.gu );

// ⑥ 创建通知，注：第二个参数是Channel的id，一定要和通知渠道的id保持一致，否则不然通知不会显示
notification = new Notification.Builder( 当前Activity.this, CHANNEL_ID )
    .setContentTitle("提醒") //通知标题
    .setContentText("通知内容…") //通知内容
    .setWhen( System.currentTimeMillis() ) //通知产生的时间
    .setShowWhen(true) //显示时间
    .setSmallIcon( R.drawable.twitter ) //小图标
    .setLargeIcon( bitmap ) //大图标Bitmap
    .setAutoCancel(true) //通知点击后自动删除
    .setContentIntent(pendingIntent) //设置通知点击的Intent
    .build(); //构建通知

// ⑦ 发送通知
manager.notify( NOTIFY_ID, notification );

示例：新建NotificationActivity

activity_notification

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".NotificationActivity">
<Button
    android:id="@+id/btn_send"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:layout_marginTop="120dp"
    android:text="发送通知"
    android:textSize="20sp"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintHorizontal_bias="0.498"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>

NotificationActivity.java

public class NotificationActivity extends AppCompatActivity {
    //① 相关成员定义
    private static final int NOTIFY_ID = 1; //通知的id (自拟)
    private static final String CHANNEL_ID = "123"; //通知渠道的id (自拟)
    private static final String CHANNEL_Name = "mychannel"; //通知渠道的名称(自拟)
    NotificationManager manager; //通知管理类
    Notification notification; //通知类
    NotificationChannel channel; //通知渠道
    PendingIntent pendingIntent; //延迟Intent
    Bitmap bitmap; //通知的LargeIcon
    // (1) 创建权限申请的启动器
    private final ActivityResultLauncher permissionLauncher = registerForActivityResult(
            new ActivityResultContracts.RequestPermission(),
            new ActivityResultCallback<Boolean>() {
                @Override
                public void onActivityResult(Boolean result) {
                    if (result) { // true表示申请成功
                        sendNotify();
                    }
                }
            }
    );
    // (2) 在需要的时候启动权限请求
    private void requestPermission() {
        permissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS);
    }
    public void sendNotify(){
        // ② 创建通知管理器
        manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
        
        // ③ 创建通知渠道
        channel = new NotificationChannel(CHANNEL_ID, CHANNEL_Name,
                NotificationManager.IMPORTANCE_HIGH);
        manager.createNotificationChannel(channel);
        
        // ④ 创建PendingIntent
        Intent intent = new Intent(NotificationActivity.this, LoginActivity.class);
        pendingIntent = PendingIntent.getActivity(NotificationActivity.this, 0,
                intent, PendingIntent.FLAG_IMMUTABLE);
        
        // ⑤ 创建大图标的Bitmap
        bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.gu);
        
        // ⑥ 创建通知，注：第二个参数是Channel的id，
        // 一定要和通知渠道的id保持一致，否则不然通知不会显示
        notification = new Notification.Builder(NotificationActivity.this, CHANNEL_ID)
                .setContentTitle("提醒") //通知标题
                .setContentText("通知内容…") //通知内容
                .setWhen(System.currentTimeMillis()) //通知产生的时间
                .setShowWhen(true) //显示时间
                .setSmallIcon(R.drawable.twitter) //小图标
                .setLargeIcon(bitmap) //大图标Bitmap
                .setAutoCancel(true) //通知点击后自动删除
                .setContentIntent(pendingIntent) //设置通知点击的Intent
                .build(); //构建通知
        
        // ⑦ 发送通知
        manager.notify(NOTIFY_ID, notification);
    }
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_notification);
        // 用按钮来发送通知
        Button btn = (Button) findViewById(R.id.btn_send);
        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
                requestPermission(); //申请权限
            }
        });
    }
}

Intent概述

Intent类型

显式Intent

隐式Intent

延迟Intent

Intent构成

Intent-Filter

隐式Intent启动过程

Intent-Filter

隐式Intent匹配规则

Intent传递数据

单向传值

双向传值

注册方式（新API）

注册方式示例

示例1：登录信息回传

示例2：手机相册选取图片显示

示例3：打开相机拍照并显示

示例4：选择视频播放

示例5：权限申请 （重要）

Notification编程

通知权限

通知编程

示例5：权限申请（重要）