文章目录
- NotificationListenerService
- 代码获取播放音乐
- 步骤 1：声明权限和服务
- 步骤 2：实现NotificationListenerService
- 步骤 3：请求用户启用通知监听权限
- 启动服务
- 注意事项
- 获取播放信息如下图：
NotificationListenerService
NotificationListenerService 是 Android 系统提供的一个特殊服务，允许应用监听和获取其他应用发出的通知。通过这个服务，开发者可以读取通知的内容、发送时间、来源应用等信息，还可以对通知进行操作（如删除通知）。
核心功能。
- 监听通知：获取系统中所有应用发出的通知。
- 读取通知内容：包括标题、文本、图标等。
- 通知操作：删除通知或执行通知中的操作。
在 Android 中使用 NotificationListenerService 监听媒体播放器状态是可行的，因为大多数媒体应用（如音乐播放器、视频播放器）会在发出的通知中包含当前播放状态（播放 / 暂停）、曲目信息（标题、艺术家、专辑）等内容。下面介绍如何实现这一功能。
注意：有一些应用NotificationListenerService是监听不到播放状态的，比如其不发通知，或者是在后台播放情况下没有通知，这种可以考虑不使用NotificationListenerService实现，而是用一个定时器去轮询MediaSessionManager的getActiveSessions()函数获取音乐信息，这里不贴代码了。
代码获取播放音乐
步骤 1：声明权限和服务
在AndroidManifest.xml中添加以下权限和服务：
<uses-permission android:name="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE" />
<serviceandroid:name=".MediaSessionListenerService"android:label="Notification Listener"android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE">
<intent-filter><action android:name="android.service.notification.NotificationListenerService" />
</intent-filter>
</service>步骤 2：实现NotificationListenerService
创建MediaSessionListenerService类继承NotificationListenerService：
import android.app.Notification;
import android.media.session.MediaController;
import android.media.MediaMetadata;
import android.media.session.MediaSession;
import android.media.session.PlaybackState;
import android.os.Bundle;
import android.service.notification.NotificationListenerService;
import android.service.notification.StatusBarNotification;
import android.util.Log;
public class MediaSessionListenerService extends NotificationListenerService {
private static final String TAG = "MusicProgressListener";
private MediaController mMediaController;
private String currentPlayingPackage;
public void onMusicStateChanged(PlaybackState state) {
if (state != null) {
long currentPosition = state.getPosition();
Log.d(TAG, "[" + currentPlayingPackage + "] 当前进度: " + currentPosition + " ms");
}
}
public void onMusicMetadataChanged(MediaMetadata metadata) {
if (metadata != null) {
long duration = metadata.getLong(MediaMetadata.METADATA_KEY_DURATION);
String title = metadata.getString(MediaMetadata.METADATA_KEY_TITLE);
String artist = metadata.getString(MediaMetadata.METADATA_KEY_ARTIST);
Log.d(TAG, "[" + currentPlayingPackage + "] 歌曲: " + title + " - " + artist);
Log.d(TAG, "[" + currentPlayingPackage + "] 总时长: " + duration + " ms");
}
}
private final MediaController.Callback mControllerCallback = new MediaController.Callback() {
@Override
public void onPlaybackStateChanged(PlaybackState state) {
onMusicStateChanged(state);
}
@Override
public void onMetadataChanged(MediaMetadata metadata) {
onMusicMetadataChanged(metadata);
}
};
@Override
public void onListenerConnected() {
super.onListenerConnected();
Log.d(TAG, "通知监听服务已连接");
// 服务连接后，立即检查当前是否有活跃的媒体会话
checkActiveMediaSessions();
}
@Override
public void onNotificationPosted(StatusBarNotification sbn) {
super.onNotificationPosted(sbn);
// 当有新通知发出时，检查是否是媒体通知
handleMediaNotification(sbn);
}
@Override
public void onNotificationRemoved(StatusBarNotification sbn) {
super.onNotificationRemoved(sbn);
// 当媒体通知被移除时（如音乐停止），清理资源
if (isMediaNotification(sbn)) {
// 确保只清理当前正在播放的会话
if (mMediaController != null && sbn.getPackageName().equals(currentPlayingPackage)) {
mMediaController.unregisterCallback(mControllerCallback);
mMediaController = null;
currentPlayingPackage = null; // 重置包名
Log.d(TAG, "媒体会话已断开: " + sbn.getPackageName());
}
}
}
private void checkActiveMediaSessions() {
StatusBarNotification[] activeMediaSessions = getActiveNotifications();
if (activeMediaSessions != null && activeMediaSessions.length > 0) {
// 通常我们只关心第一个活跃的媒体会话
handleMediaNotification(activeMediaSessions[0]);
}
}
private void handleMediaNotification(StatusBarNotification sbn) {
if (!isMediaNotification(sbn)) {
return;
}
// 如果已经是当前正在处理的包，无需重复操作
if (sbn.getPackageName().equals(currentPlayingPackage)) {
return;
}
try {
Bundle extras = sbn.getNotification().extras;
MediaSession.Token token = extras.getParcelable(Notification.EXTRA_MEDIA_SESSION);
if (token != null) {
// 如果已经有一个控制器，先注销它
if (mMediaController != null) {
mMediaController.unregisterCallback(mControllerCallback);
}
// 创建新的 MediaController
mMediaController = new MediaController(this, token);
mMediaController.registerCallback(mControllerCallback);
// 从 StatusBarNotification 获取包名并存储
currentPlayingPackage = sbn.getPackageName();
Log.d(TAG, "已连接到媒体会话: " + currentPlayingPackage);
// 立即获取一次当前状态，防止错过回调
PlaybackState state = mMediaController.getPlaybackState();
MediaMetadata metadata = mMediaController.getMetadata();
if (state != null) {
onMusicStateChanged(state);
}
if (metadata != null) {
onMusicMetadataChanged(metadata);
}
}
} catch (Exception e) {
Log.e(TAG, "处理媒体通知时出错", e);
}
}
private boolean isMediaNotification(StatusBarNotification sbn) {
// 判断一个通知是否为媒体通知
Notification notification = sbn.getNotification();
return notification != null && notification.extras != null
&& notification.extras.containsKey(Notification.EXTRA_MEDIA_SESSION);
}
}步骤 3：请求用户启用通知监听权限
在Activity中检查并请求权限，系统不会自动授予此权限。你需要引导用户去设置页面手动开启：
MainActivity.java
private void checkNotificationListenerPermission() {
if (!isNotificationServiceEnabled()) {
startActivity(new Intent("android.settings.ACTION_NOTIFICATION_LISTENER_SETTINGS"));
}
}
private boolean isNotificationServiceEnabled() {
String packageName = getPackageName();
String flat = Settings.Secure.getString(getContentResolver(), "enabled_notification_listeners");
if (flat != null) {
String[] names = flat.split(":");
for (String name : names) {
ComponentName cn = ComponentName.unflattenFromString(name);
if (cn != null && cn.getPackageName().equals(packageName)) {
return true;
}
}
}
return false;
}然后MainActivity.java中调用
checkNotificationListenerPermission();用户必须点击进入设置，并手动开启你的 App 的“通知监听”开关。
启动服务
通常不需要显式启动 NotificationListenerService，只要用户开启了权限，系统就会自动绑定并运行服务。
但你可以调用以下代码来“尝试”触发绑定（实际是否运行仍由系统控制），
// 可以尝试启动服务（非必需）
Intent intent = new Intent(this, MediaSessionListenerService.class);
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
startForegroundService(intent);
} else {
startService(intent);
}运行正常的话onListenerConnected()会被自动调用
@Override
public void onListenerConnected() {
super.onListenerConnected();
Log.d(TAG, "通知监听服务已连接"); // 这行会被执行
checkActiveMediaSessions();
}你可以在 Logcat 中搜索 “通知监听服务已连接” 来确认是否成功触发。
注意事项
- 用户授权：必须引导用户到设置中启用应用的通知监听权限。
- 媒体会话限制：并非所有应用都使用MediaSession，因此可能无法检测到所有播放情况。
- 多应用播放：可能存在多个应用同时播放的情况，需根据业务逻辑处理。
如果报以下错误，
java.lang.SecurityException: Missing permission to control media.
需要加上这个权限
获取播放信息如下图：
注意上面有总时长为-1的，这个是不对的需要特殊处理。
作者：帅得不敢出门
)
