Implement support for notification.vibrate

chrome/android/java/src/org/chromium/chrome/browser/notifications/NotificationUIManager.java

 // Copyright 2014 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 package org.chromium.chrome.browser.notifications;
 
 import android.app.Notification;
 import android.app.NotificationManager;
 import android.app.PendingIntent;
 import android.content.Context;
@@ skipping 275 matching lines @@
             URI uri = new URI(parts[1]);
             if (uri.getHost() != null) return parts[1];
         } catch (URISyntaxException e) {
             Log.e(TAG, "Expected to find a valid url in the notification tag extra.", e);
             return null;
         }
         return null;
     }
 
     /**
+     * Generates the notfiication defaults from vibrationPattern's size and silent.
+     *
+     * Use the system's default ringtone, vibration and indicator lights unless the notification
+     * has been marked as being silent.
+     * If a vibration pattern is set, the notification should use the provided pattern
+     * rather than the defaulting to system settings.
+     *
+     * @param vibrationPatternLength Vibration pattern's size for the Notification.
+     * @param silent Whether the default sound, vibration and lights should be suppressed.
+     * @return The generated notification's default value.
+    */
+    @VisibleForTesting
+    static int makeDefaults(int vibrationPatternLength, boolean silent) {
+        assert !silent || vibrationPatternLength == 0;
+
+        if (silent) return 0;
+
+        int defaults = Notification.DEFAULT_ALL;
+        if (vibrationPatternLength > 0) {
+            defaults &= ~Notification.DEFAULT_VIBRATE;
+        }
+        return defaults;
+    }
+
+    /**
+     * Generates the vibration pattern used in Android notification.
+     *
+     * Android takes a long array where the first entry indicates the number of milliseconds to wait
+     * prior to starting the vibration, whereas Chrome follows the syntax of the Web Vibration API.
+     *
+     * @param vibrationPattern Vibration pattern following the Web Vibration API syntax.
+     * @return Vibration pattern following the Android syntax.
+    */
+    @VisibleForTesting
+    static long[] makeVibrationPattern(int[] vibrationPattern) {
+        long[] pattern = new long[vibrationPattern.length + 1];
+        for (int i = 0; i < vibrationPattern.length; ++i) {
+            pattern[i + 1] = vibrationPattern[i];
+        }
+        return pattern;
+    }
+
+    /**
      * Displays a notification with the given details.
      *
      * @param persistentNotificationId The persistent id of the notification.
      * @param origin Full text of the origin, including the protocol, owning this notification.
      * @param tag A string identifier for this notification. If the tag is not empty, the new
      *            notification will replace the previous notification with the same tag and origin,
      *            if present. If no matching previous notification is present, the new one will just
      *            be added.
      * @param title Title to be displayed in the notification.
      * @param body Message to be displayed in the notification. Will be trimmed to one line of
      *             text by the Android notification system.
      * @param icon Icon to be displayed in the notification. When this isn't a valid Bitmap, a
      *             default icon will be generated instead.
+     * @param vibrationPattern Vibration pattern following the Web Vibration syntax.
      * @param silent Whether the default sound, vibration and lights should be suppressed.
+     * @see https://developer.android.com/reference/android/app/Notification.html
      */
     @CalledByNative
     private void displayNotification(long persistentNotificationId, String origin, String tag,
-            String title, String body, Bitmap icon, boolean silent) {
+            String title, String body, Bitmap icon, int[] vibrationPattern, boolean silent) {
         if (icon == null || icon.getWidth() == 0) {
             icon = getIconGenerator().generateIconForUrl(origin, true);
         }
 
         Resources res = mAppContext.getResources();
 
         // The data used to make each intent unique according to the rules of Intent#filterEquals.
         // Without this, the pending intents derived from them may be reused, because extras are
         // not taken into account for the filterEquals comparison.
         Uri intentData = Uri.parse(origin).buildUpon().fragment(
@@ skipping 20 matching lines @@
                         persistentNotificationId, origin, tag, intentData))
                 .setDeleteIntent(getPendingIntent(
                         NotificationConstants.ACTION_CLOSE_NOTIFICATION,
                         persistentNotificationId, origin, tag, intentData))
                 .addAction(R.drawable.settings_cog,
                            res.getString(R.string.page_info_site_settings_button),
                            pendingSettingsIntent)
                 .setTicker(createTickerText(title, body))
                 .setSubText(origin);
 
-        // Use the system's default ringtone, vibration and indicator lights unless the notification
-        // has been marked as being silent, for example because it's low priority.
-        if (!silent) notificationBuilder.setDefaults(Notification.DEFAULT_ALL);
+        notificationBuilder.setDefaults(makeDefaults(vibrationPattern.length, silent));
+        if (vibrationPattern.length > 0) {
+            notificationBuilder.setVibrate(makeVibrationPattern(vibrationPattern));
+        }
 
         String platformTag = makePlatformTag(persistentNotificationId, origin, tag);
         mNotificationManager.notify(platformTag, PLATFORM_ID, notificationBuilder.build());
     }
 
     /**
      * Creates the ticker text for a notification having |title| and |body|. The notification's
      * title will be printed in bold, followed by the text of the body.
      *
      * @param title Title of the notification.
@@ skipping 95 matching lines @@
                                           origin, tag);
     }
 
     private static native void nativeInitializeNotificationUIManager();
 
     private native boolean nativeOnNotificationClicked(long nativeNotificationUIManagerAndroid,
             long persistentNotificationId, String origin, String tag);
     private native boolean nativeOnNotificationClosed(long nativeNotificationUIManagerAndroid,
             long persistentNotificationId, String origin, String tag);
 }