はじめに
Androidの通知(Notification)に関する使用方法を記載いたします。
内容は複数の通知を送ることです。
サンプルアプリをベースに説明いたします。
開発環境は以下の通りです。
- Android Studio Electric Eel | 2022.1.1 Patch 2
- Runtime version: 11.0.15+0-b2043.56-8887301 aarch64
- macOS 13.4
- Android Virtual Device - android12.0 / 1440 x 2560
Notificationとは
公式サイトに以下の記述があります。
通知は、アプリの UI の外で Android が表示するメッセージであり、
リマインダー、他の人からのメッセージ、
アプリからのタイムリーな情報などをユーザーに提供します。
ユーザーは通知をタップしてアプリを開いたり、通知から直接操作したりできます。
サンプルアプリの動作内容
サンプルアプリの処理フローは以下の通りです。
- 画面に表示している"押下"ボタンを押下
- 通知を送信する
環境構築
Android Studio で作成されたほとんどのプロジェクトには、
NotificationCompat を使用するために必要な依存関係が含まれております。
しかし、念のためモジュール レベルの build.gradle ファイルに次の依存関係が
含まれていることを確認します。
dependencies {
implementation "com.android.support:support-compat:28.0.0"
}
次に、AndroidManifestに以下のパーミッションを追記いたします。
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<uses-permission android:name="android.permission.VIBRATE" />
※ Android13以降は実行時の権限も取得しておく必要があります。
そのため、実行時の権限をリクエストしたい際は、
以下のリンクを参考にしてください。
実行時の権限をリクエストする
最後に、通知に表示させるアイコンを作成します。
適当なファイルを右クリックし、New → Vector Assetをクリックします。
すると、以下の画面が表示されます。
上記画面のNameをic_notification_iconに設定し、
Nextをクリックすることでアイコンを作成できます。
※ Nameやアイコンの画像は、自身が気に入ったモノにしていただいて結構です。
実装
環境構築が終わったので、実装に入っていきます。
最初に、画面のレイアウトについて記載している
activity_mainファイルを紹介します。
<?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">
<Button
android:id="@+id/notificationButton"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="通知"
android:textSize="24sp"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
</androidx.constraintlayout.widget.ConstraintLayout>
次に、ボタンが押下された際に、
通知処理を呼ぶ処理が記載されているMainActivityファイルを紹介します。
import android.os.Bundle
import android.view.View
import android.widget.Button
import androidx.appcompat.app.AppCompatActivity
class MainActivity : AppCompatActivity(), View.OnClickListener {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val noticeBotton = findViewById<Button>(R.id.notificationButton)
noticeBotton.setOnClickListener(this)
}
/**
* ボタンを押下された際、発火する
* @param v View
*/
override fun onClick(v: View?) {
createNotificationChannelOne(this)
createNotificationChannelTwo(this)
}
}
最後に、通知を送信する処理を記載しているNoticeファイルを紹介します。
import android.app.NotificationChannel
import android.app.NotificationManager
import android.content.Context
import android.os.Build
import androidx.core.app.NotificationCompat
// 通知チャネルのID
private val CHANNEL_ID = "my_channel_id"
// 通知の重要度
private val NOTIFICATION_PRIORITY = NotificationCompat.PRIORITY_DEFAULT
/**
* 通知を作成し、送信する処理の一つ目
* @param context コンテキスト
*/
fun createNotificationChannelOne(context: Context){
// チャンネルをシステムに登録する
val notificationManager: NotificationManager =
context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
// NotificationChannelを作成する、ただしAPI26+の場合のみなので
// NotificationChannelクラスは新しいもので、サポートライブラリにはありません。
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
val name = "通知管理アプリ"
val importance = NotificationManager.IMPORTANCE_DEFAULT
val channel = NotificationChannel(CHANNEL_ID, name, importance)
notificationManager.createNotificationChannel(channel)
}
// NotificationCompat.Builderを使用して通知を作成
var builder = NotificationCompat.Builder(context, CHANNEL_ID)
.setSmallIcon(R.drawable.ic_notification_icon)
.setContentTitle("通知管理")
.setContentText("通知を送信いたしました。")
.setPriority(NOTIFICATION_PRIORITY)
// 通知を表示
notificationManager.notify(/* 通知ID */ 1, builder.build())
}
/**
* 通知を作成し、送信する処理の二つ目
* @param context コンテキスト
*/
fun createNotificationChannelTwo(context: Context){
// チャンネルをシステムに登録する
val notificationManager: NotificationManager =
context.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
// NotificationChannelを作成する、ただしAPI26+の場合のみなので
// NotificationChannelクラスは新しいもので、サポートライブラリにはありません。
if(Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
val name = "通知管理アプリ"
val importance = NotificationManager.IMPORTANCE_DEFAULT
val channel = NotificationChannel(CHANNEL_ID, name, importance)
notificationManager.createNotificationChannel(channel)
}
// NotificationCompat.Builderを使用して通知を作成
var builder = NotificationCompat.Builder(context, CHANNEL_ID)
.setSmallIcon(R.drawable.ic_notification_icon)
.setContentTitle("通知管理")
.setContentText("2個目の通知を送信いたしました。")
.setPriority(NOTIFICATION_PRIORITY)
// 通知を表示
notificationManager.notify(/* 通知ID */ 2, builder.build())
}
以上で、ボタンが押下されると通知が複数送信されます。
まとめ
今回は、通知を複数送信する処理について記載いたしましたが、
通知を押下すると、アプリ画面に遷移する処理や、
通知をグループ化する処理もあります。
そのため、余裕がございましたら、チャレンジをしてみてもよいかもしれません。
参考資料
通知を作成する | Android デベロッパー
通知の概要 | Android デベロッパー
今さらだけど！ AndroidのNotificationをJavaで実装してみる
実行時の権限をリクエストする
Manifest.permission
Android での権限