Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "fix javadoc build also add some docs to the service" into jb-mr2-dev

Browse Source
This commit is contained in:
Scott Main
2013-04-26 01:57:00 +00:00
committed by Android (Google) Code Review
parent bbd90f8e70 04667dae3a
commit 5e5aeb4684
1 changed files with 15 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
core/java/android/service/notification/NotificationListenerService.java
View File

@@ -25,6 +25,20 @@ import android.os.IBinder;
import android.os.ServiceManager; import android.os.ServiceManager;
import android.util.Log; import android.util.Log;
/**
* A service that receives calls from the system when new notifications are posted or removed.
* <p>To extend this class, you must declare the service in your manifest file with
* the {@link android.Manifest.permission#BIND_NOTIFICATION_LISTENER_SERVICE} permission
* and include an intent filter with the {@link #SERVICE_INTERFACE} action. For example:</p>
* <pre>
* &lt;service android:name=".NotificationListener"
* android:label="&#64;string/service_name"
* android:permission="android.permission.BIND_NOTIFICATION_LISTENER_SERVICE">
* &lt;intent-filter>
* &lt;action android:name="android.service.notification.NotificationListenerService" />
* &lt;/intent-filter>
* &lt;/service></pre>
*/
public abstract class NotificationListenerService extends Service { public abstract class NotificationListenerService extends Service {
// TAG = "NotificationListenerService[MySubclass]" // TAG = "NotificationListenerService[MySubclass]"
private final String TAG = NotificationListenerService.class.getSimpleName() private final String TAG = NotificationListenerService.class.getSimpleName()
@@ -57,7 +71,7 @@ public abstract class NotificationListenerService extends Service {
* notification listener) or because the app has withdrawn the notification. * notification listener) or because the app has withdrawn the notification.
* <P> * <P>
* NOTE: The {@link StatusBarNotification} object you receive will be "light"; that is, the * NOTE: The {@link StatusBarNotification} object you receive will be "light"; that is, the
* {@link StatusBarNotification#notification} member may be missing some heavyweight * result from {@link StatusBarNotification#getNotification} may be missing some heavyweight
* fields such as {@link android.app.Notification#contentView} and * fields such as {@link android.app.Notification#contentView} and
* {@link android.app.Notification#largeIcon}. However, all other fields on * {@link android.app.Notification#largeIcon}. However, all other fields on
* {@link StatusBarNotification}, sufficient to match this call with a prior call to * {@link StatusBarNotification}, sufficient to match this call with a prior call to