ภาพรวม
ตัวอย่างพื้นฐานการใช้ NotificationCompat.Builder สร้างการแจ้งเตือนมาตรฐานใน Android รองรับทุกเวอร์ชันผ่าน Support Library
ขั้นตอนที่ 1: สร้างโปรเจกต์ใหม่
Android Studio → File → New Project → Empty Activity
ขั้นตอนที่ 2: Layout (activity_main.xml)
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
xmlns:tools="https://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<Button
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_centerInParent="true"
android:layout_margin="16dp"
android:onClick="createNotification"
android:text="create notification" />
</RelativeLayout>
ขั้นตอนที่ 3: MainActivity - NotificationBuilder พื้นฐาน
package app.tutorialspoint.com.notifyme;
import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.os.Build;
import android.os.Bundle;
import android.support.v4.app.NotificationCompat;
import android.support.v7.app.AppCompatActivity;
import android.view.View;
public class MainActivity extends AppCompatActivity {
public static final String NOTIFICATION_CHANNEL_ID = "10001";
private final static String default_notification_channel_id = "default";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
}
public void createNotification(View view) {
NotificationManager mNotificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(MainActivity.this, default_notification_channel_id);
// ตั้งค่าพื้นฐาน
mBuilder.setContentTitle("Notify Me 😀");
mBuilder.setContentText("Something important!");
mBuilder.setSmallIcon(R.drawable.ic_launcher_foreground);
mBuilder.setAutoCancel(true); // หายเมื่อกด
// สร้าง Notification Channel สำหรับ Android 8.0+
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
int importance = NotificationManager.IMPORTANCE_HIGH;
NotificationChannel notificationChannel = new NotificationChannel(
NOTIFICATION_CHANNEL_ID, "NOTIFICATION_CHANNEL_NAME", importance);
mBuilder.setChannelId(NOTIFICATION_CHANNEL_ID);
assert mNotificationManager != null;
mNotificationManager.createNotificationChannel(notificationChannel);
}
assert mNotificationManager != null;
mNotificationManager.notify((int) System.currentTimeMillis(), mBuilder.build());
}
}
ขั้นตอนที่ 4: AndroidManifest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
package="app.tutorialspoint.com.notifyme">
<uses-permission android:name="android.permission.VIBRATE" />
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/AppTheme">
<activity android:name=".MainActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>
เมธอดหลักของ NotificationCompat.Builder
| เมธอด | คำอธิบาย |
|---|---|
| setContentTitle() | หัวข้อหลักของการแจ้งเตือน |
| setContentText() | ข้อความรายละเอียด |
| setSmallIcon() | ไอคอนเล็กใน Status Bar (บังคับ) |
| setLargeIcon() | ไอคอนใหญ่ด้านซ้าย (Bitmap) |
| setAutoCancel() | true = หายเมื่อกด, false = อยู่ตลอด |
| setContentIntent() | PendingIntent เมื่อกดที่การแจ้งเตือน |
| setStyle() | BigTextStyle, InboxStyle, BigPictureStyle, MediaStyle |
| setPriority() | PRIORITY_MIN ถึง PRIORITY_MAX |
| setCategory() | CATEGORY_MESSAGE, CATEGORY_EMAIL, ฯลฯ |
| setChannelId() | Channel ID สำหรับ Android 8.0+ |
| addAction() | เพิ่มปุ่ม Action |
| setVibrate() | รูปแบบการสั่น |
| setSound() | เสียงแจ้งเตือน |
| setLights() | ไฟ LED (ถ้าอุปกรณ์รองรับ) |
แนวทางปฏิบัติที่ดี
- ใช้
System.currentTimeMillis()หรือ ID เฉพาะสำหรับ notify() เพื่อไม่ให้ทับซ้อน - สร้าง Channel ครั้งเดียว (ใน Application class หรือเมื่อแอปเริ่ม)
- ตั้งค่า Importance ให้เหมาะสม: HIGH สำคัญ, DEFAULT ปกติ, LOW ไม่ด่วน
- ทดสอบบน Android 8.0+ (ต้องมี Channel) และ Android 7.1- (ไม่ต้องมี Channel)