1 /* 2 Copyright 2016 The Android Open Source Project 3 4 Licensed under the Apache License, Version 2.0 (the "License"); 5 you may not use this file except in compliance with the License. 6 You may obtain a copy of the License at 7 8 http://www.apache.org/licenses/LICENSE-2.0 9 10 Unless required by applicable law or agreed to in writing, software 11 distributed under the License is distributed on an "AS IS" BASIS, 12 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 See the License for the specific language governing permissions and 14 limitations under the License. 15 */ 16 package com.example.android.wearable.wear.wearnotifications; 17 18 import android.app.Notification; 19 import android.app.PendingIntent; 20 import android.content.Intent; 21 import android.graphics.BitmapFactory; 22 import android.os.Build; 23 import android.os.Bundle; 24 import android.support.design.widget.Snackbar; 25 import android.support.v4.app.NotificationCompat.BigPictureStyle; 26 import android.support.v4.app.NotificationCompat.BigTextStyle; 27 import android.support.v4.app.NotificationCompat.InboxStyle; 28 import android.support.v4.app.NotificationCompat.MessagingStyle; 29 import android.support.v4.app.NotificationManagerCompat; 30 import android.support.v4.app.RemoteInput; 31 import android.support.v4.app.TaskStackBuilder; 32 import android.support.v7.app.AppCompatActivity; 33 import android.support.v7.app.NotificationCompat; 34 import android.util.Log; 35 import android.view.View; 36 import android.widget.AdapterView; 37 import android.widget.ArrayAdapter; 38 import android.widget.RelativeLayout; 39 import android.widget.Spinner; 40 import android.widget.TextView; 41 42 43 44 import com.example.android.wearable.wear.wearnotifications.handlers.BigPictureSocialIntentService; 45 import com.example.android.wearable.wear.wearnotifications.handlers.BigPictureSocialMainActivity; 46 import com.example.android.wearable.wear.wearnotifications.handlers.BigTextIntentService; 47 import com.example.android.wearable.wear.wearnotifications.handlers.BigTextMainActivity; 48 import com.example.android.wearable.wear.wearnotifications.handlers.InboxMainActivity; 49 import com.example.android.wearable.wear.wearnotifications.handlers.MessagingIntentService; 50 import com.example.android.wearable.wear.wearnotifications.handlers.MessagingMainActivity; 51 import com.example.android.wearable.wear.wearnotifications.mock.MockDatabase; 52 53 /** 54 * The Activity demonstrates several popular Notification.Style examples along with their best 55 * practices (include proper Android Wear support when you don't have a dedicated Android Wear 56 * app). 57 */ 58 public class MainActivity extends AppCompatActivity implements AdapterView.OnItemSelectedListener { 59 60 public static final String TAG = "MainActivity"; 61 62 public static final int NOTIFICATION_ID = 888; 63 64 // Used for Notification Style array and switch statement for Spinner selection 65 private static final String BIG_TEXT_STYLE = "BIG_TEXT_STYLE"; 66 private static final String BIG_PICTURE_STYLE = "BIG_PICTURE_STYLE"; 67 private static final String INBOX_STYLE = "INBOX_STYLE"; 68 private static final String MESSAGING_STYLE = "MESSAGING_STYLE"; 69 70 // Collection of notification styles to back ArrayAdapter for Spinner 71 private static final String[] NOTIFICATION_STYLES = 72 {BIG_TEXT_STYLE, BIG_PICTURE_STYLE, INBOX_STYLE, MESSAGING_STYLE}; 73 74 private static final String[] NOTIFICATION_STYLES_DESCRIPTION = 75 { 76 "Demos reminder type app using BIG_TEXT_STYLE", 77 "Demos social type app using BIG_PICTURE_STYLE + inline notification response", 78 "Demos email type app using INBOX_STYLE", 79 "Demos messaging app using MESSAGING_STYLE + inline notification responses" 80 }; 81 82 private NotificationManagerCompat mNotificationManagerCompat; 83 84 private int mSelectedNotification = 0; 85 86 // RelativeLayout is needed for SnackBars to alert users when Notifications are disabled for app 87 private RelativeLayout mMainRelativeLayout; 88 private Spinner mSpinner; 89 private TextView mNotificationDetailsTextView; 90 91 @Override 92 protected void onCreate(Bundle savedInstanceState) { 93 94 super.onCreate(savedInstanceState); 95 setContentView(R.layout.activity_main); 96 97 mMainRelativeLayout = (RelativeLayout) findViewById(R.id.mainRelativeLayout); 98 mNotificationDetailsTextView = (TextView) findViewById(R.id.notificationDetails); 99 mSpinner = (Spinner) findViewById(R.id.spinner); 100 101 mNotificationManagerCompat = NotificationManagerCompat.from(getApplicationContext()); 102 103 // Create an ArrayAdapter using the string array and a default spinner layout 104 ArrayAdapter<CharSequence> adapter = 105 new ArrayAdapter( 106 this, 107 android.R.layout.simple_spinner_item, 108 NOTIFICATION_STYLES); 109 // Specify the layout to use when the list of choices appears 110 adapter.setDropDownViewResource(android.R.layout.simple_spinner_dropdown_item); 111 // Apply the adapter to the spinner 112 mSpinner.setAdapter(adapter); 113 mSpinner.setOnItemSelectedListener(this); 114 } 115 116 @Override 117 public void onItemSelected(AdapterView<?> parent, View view, int position, long id) { 118 Log.d(TAG, "onItemSelected(): position: " + position + " id: " + id); 119 120 mSelectedNotification = position; 121 122 mNotificationDetailsTextView.setText( 123 NOTIFICATION_STYLES_DESCRIPTION[mSelectedNotification]); 124 } 125 @Override 126 public void onNothingSelected(AdapterView<?> parent) { 127 // Required 128 } 129 130 public void onClick(View view) { 131 132 Log.d(TAG, "onClick()"); 133 134 boolean areNotificationsEnabled = mNotificationManagerCompat.areNotificationsEnabled(); 135 136 if (!areNotificationsEnabled) { 137 // Because the user took an action to create a notification, we create a prompt to let 138 // the user re-enable notifications for this application again. 139 Snackbar snackbar = Snackbar 140 .make( 141 mMainRelativeLayout, 142 "You need to enable notifications for this app", 143 Snackbar.LENGTH_LONG) 144 .setAction("ENABLE", new View.OnClickListener() { 145 @Override 146 public void onClick(View view) { 147 // Links to this app's notification settings 148 openNotificationSettingsForApp(); 149 } 150 }); 151 snackbar.show(); 152 return; 153 } 154 155 String notificationStyle = NOTIFICATION_STYLES[mSelectedNotification]; 156 157 switch (notificationStyle) { 158 case BIG_TEXT_STYLE: 159 generateBigTextStyleNotification(); 160 break; 161 162 case BIG_PICTURE_STYLE: 163 generateBigPictureStyleNotification(); 164 break; 165 166 case INBOX_STYLE: 167 generateInboxStyleNotification(); 168 break; 169 170 case MESSAGING_STYLE: 171 generateMessagingStyleNotification(); 172 break; 173 174 default: 175 // continue below 176 } 177 } 178 179 /* 180 * Generates a BIG_TEXT_STYLE Notification that supports both phone/tablet and wear. For devices 181 * on API level 16 (4.1.x - Jelly Bean) and after, displays BIG_TEXT_STYLE. Otherwise, displays 182 * a basic notification. 183 */ 184 private void generateBigTextStyleNotification() { 185 186 Log.d(TAG, "generateBigTextStyleNotification()"); 187 188 // Main steps for building a BIG_TEXT_STYLE notification: 189 // 0. Get your data 190 // 1. Build the BIG_TEXT_STYLE 191 // 2. Set up main Intent for notification 192 // 3. Create additional Actions for the Notification 193 // 4. Build and issue the notification 194 195 // 0. Get your data (everything unique per Notification) 196 MockDatabase.BigTextStyleReminderAppData bigTextStyleReminderAppData = 197 MockDatabase.getBigTextStyleData(); 198 199 // 1. Build the BIG_TEXT_STYLE 200 BigTextStyle bigTextStyle = new NotificationCompat.BigTextStyle() 201 // Overrides ContentText in the big form of the template 202 .bigText(bigTextStyleReminderAppData.getBigText()) 203 // Overrides ContentTitle in the big form of the template 204 .setBigContentTitle(bigTextStyleReminderAppData.getBigContentTitle()) 205 // Summary line after the detail section in the big form of the template 206 // Note: To improve readability, don't overload the user with info. If Summary Text 207 // doesn't add critical information, you should skip it. 208 .setSummaryText(bigTextStyleReminderAppData.getSummaryText()); 209 210 211 // 2. Set up main Intent for notification 212 Intent notifyIntent = new Intent(this, BigTextMainActivity.class); 213 214 // When creating your Intent, you need to take into account the back state, i.e., what 215 // happens after your Activity launches and the user presses the back button. 216 217 // There are two options: 218 // 1. Regular activity - You're starting an Activity that's part of the application's 219 // normal workflow. 220 221 // 2. Special activity - The user only sees this Activity if it's started from a 222 // notification. In a sense, the Activity extends the notification by providing 223 // information that would be hard to display in the notification itself. 224 225 // For the BIG_TEXT_STYLE notification, we will consider the activity launched by the main 226 // Intent as a special activity, so we will follow option 2. 227 228 // For an example of option 1, check either the MESSAGING_STYLE or BIG_PICTURE_STYLE 229 // examples. 230 231 // For more information, check out our dev article: 232 // https://developer.android.com/training/notify-user/navigation.html 233 234 // Sets the Activity to start in a new, empty task 235 notifyIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK); 236 237 PendingIntent notifyPendingIntent = 238 PendingIntent.getActivity( 239 this, 240 0, 241 notifyIntent, 242 PendingIntent.FLAG_UPDATE_CURRENT 243 ); 244 245 246 // 3. Create additional Actions (Intents) for the Notification 247 248 // In our case, we create two additional actions: a Snooze action and a Dismiss action 249 // Snooze Action 250 Intent snoozeIntent = new Intent(this, BigTextIntentService.class); 251 snoozeIntent.setAction(BigTextIntentService.ACTION_SNOOZE); 252 253 PendingIntent snoozePendingIntent = PendingIntent.getService(this, 0, snoozeIntent, 0); 254 NotificationCompat.Action snoozeAction = 255 new NotificationCompat.Action.Builder( 256 R.drawable.ic_alarm_white_48dp, 257 "Snooze", 258 snoozePendingIntent) 259 .build(); 260 261 262 // Dismiss Action 263 Intent dismissIntent = new Intent(this, BigTextIntentService.class); 264 dismissIntent.setAction(BigTextIntentService.ACTION_DISMISS); 265 266 PendingIntent dismissPendingIntent = PendingIntent.getService(this, 0, dismissIntent, 0); 267 NotificationCompat.Action dismissAction = 268 new NotificationCompat.Action.Builder( 269 R.drawable.ic_cancel_white_48dp, 270 "Dismiss", 271 dismissPendingIntent) 272 .build(); 273 274 275 // 4. Build and issue the notification 276 277 // Because we want this to be a new notification (not updating a previous notification), we 278 // create a new Builder. Later, we use the same global builder to get back the notification 279 // we built here for the snooze action, that is, canceling the notification and relaunching 280 // it several seconds later. 281 282 NotificationCompat.Builder notificationCompatBuilder = 283 new NotificationCompat.Builder(getApplicationContext()); 284 285 GlobalNotificationBuilder.setNotificationCompatBuilderInstance(notificationCompatBuilder); 286 287 Notification notification = notificationCompatBuilder 288 // BIG_TEXT_STYLE sets title and content for API 16 (4.1 and after) 289 .setStyle(bigTextStyle) 290 // Title for API <16 (4.0 and below) devices 291 .setContentTitle(bigTextStyleReminderAppData.getContentTitle()) 292 // Content for API <24 (7.0 and below) devices 293 .setContentText(bigTextStyleReminderAppData.getContentText()) 294 .setSmallIcon(R.drawable.ic_launcher) 295 .setLargeIcon(BitmapFactory.decodeResource( 296 getResources(), 297 R.drawable.ic_alarm_white_48dp)) 298 .setContentIntent(notifyPendingIntent) 299 // Set primary color (important for Wear 2.0 Notifications) 300 .setColor(getResources().getColor(R.color.colorPrimary)) 301 302 // SIDE NOTE: Auto-bundling is enabled for 4 or more notifications on API 24+ (N+) 303 // devices and all Android Wear devices. If you have more than one notification and 304 // you prefer a different summary notification, set a group key and create a 305 // summary notification via 306 // .setGroupSummary(true) 307 // .setGroup(GROUP_KEY_YOUR_NAME_HERE) 308 309 .setCategory(Notification.CATEGORY_REMINDER) 310 .setPriority(Notification.PRIORITY_HIGH) 311 312 // Shows content on the lock-screen 313 .setVisibility(Notification.VISIBILITY_PUBLIC) 314 315 // Adds additional actions specified above 316 .addAction(snoozeAction) 317 .addAction(dismissAction) 318 319 .build(); 320 321 mNotificationManagerCompat.notify(NOTIFICATION_ID, notification); 322 } 323 324 /* 325 * Generates a BIG_PICTURE_STYLE Notification that supports both phone/tablet and wear. For 326 * devices on API level 16 (4.1.x - Jelly Bean) and after, displays BIG_PICTURE_STYLE. 327 * Otherwise, displays a basic notification. 328 * 329 * This example Notification is a social post. It allows updating the notification with 330 * comments/responses via RemoteInput and the BigPictureSocialIntentService on 24+ (N+) and 331 * Android Wear devices. 332 */ 333 private void generateBigPictureStyleNotification() { 334 335 Log.d(TAG, "generateBigPictureStyleNotification()"); 336 337 // Main steps for building a BIG_PICTURE_STYLE notification: 338 // 0. Get your data 339 // 1. Build the BIG_PICTURE_STYLE 340 // 2. Set up main Intent for notification 341 // 3. Set up RemoteInput, so users can input (keyboard and voice) from notification 342 // 4. Build and issue the notification 343 344 // 0. Get your data (everything unique per Notification) 345 MockDatabase.BigPictureStyleSocialAppData bigPictureStyleSocialAppData = 346 MockDatabase.getBigPictureStyleData(); 347 348 // 1. Build the BIG_PICTURE_STYLE 349 BigPictureStyle bigPictureStyle = new NotificationCompat.BigPictureStyle() 350 // Provides the bitmap for the BigPicture notification 351 .bigPicture( 352 BitmapFactory.decodeResource( 353 getResources(), 354 bigPictureStyleSocialAppData.getBigImage())) 355 // Overrides ContentTitle in the big form of the template 356 .setBigContentTitle(bigPictureStyleSocialAppData.getBigContentTitle()) 357 // Summary line after the detail section in the big form of the template 358 .setSummaryText(bigPictureStyleSocialAppData.getSummaryText()); 359 360 // 2. Set up main Intent for notification 361 Intent mainIntent = new Intent(this, BigPictureSocialMainActivity.class); 362 363 // When creating your Intent, you need to take into account the back state, i.e., what 364 // happens after your Activity launches and the user presses the back button. 365 366 // There are two options: 367 // 1. Regular activity - You're starting an Activity that's part of the application's 368 // normal workflow. 369 370 // 2. Special activity - The user only sees this Activity if it's started from a 371 // notification. In a sense, the Activity extends the notification by providing 372 // information that would be hard to display in the notification itself. 373 374 // Even though this sample's MainActivity doesn't link to the Activity this Notification 375 // launches directly, i.e., it isn't part of the normal workflow, a social app generally 376 // always links to individual posts as part of the app flow, so we will follow option 1. 377 378 // For an example of option 2, check out the BIG_TEXT_STYLE example. 379 380 // For more information, check out our dev article: 381 // https://developer.android.com/training/notify-user/navigation.html 382 383 TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); 384 // Adds the back stack 385 stackBuilder.addParentStack(BigPictureSocialMainActivity.class); 386 // Adds the Intent to the top of the stack 387 stackBuilder.addNextIntent(mainIntent); 388 // Gets a PendingIntent containing the entire back stack 389 PendingIntent mainPendingIntent = 390 PendingIntent.getActivity( 391 this, 392 0, 393 mainIntent, 394 PendingIntent.FLAG_UPDATE_CURRENT 395 ); 396 397 // 3. Set up RemoteInput, so users can input (keyboard and voice) from notification 398 399 // Note: For API <24 (M and below) we need to use an Activity, so the lock-screen presents 400 // the auth challenge. For API 24+ (N and above), we use a Service (could be a 401 // BroadcastReceiver), so the user can input from Notification or lock-screen (they have 402 // choice to allow) without leaving the notification. 403 404 // Create the RemoteInput 405 String replyLabel = getString(R.string.reply_label); 406 RemoteInput remoteInput = 407 new RemoteInput.Builder(BigPictureSocialIntentService.EXTRA_COMMENT) 408 .setLabel(replyLabel) 409 // List of quick response choices for any wearables paired with the phone 410 .setChoices(bigPictureStyleSocialAppData.getPossiblePostResponses()) 411 .build(); 412 413 // Pending intent = 414 // API <24 (M and below): activity so the lock-screen presents the auth challenge 415 // API 24+ (N and above): this should be a Service or BroadcastReceiver 416 PendingIntent replyActionPendingIntent; 417 418 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { 419 Intent intent = new Intent(this, BigPictureSocialIntentService.class); 420 intent.setAction(BigPictureSocialIntentService.ACTION_COMMENT); 421 replyActionPendingIntent = PendingIntent.getService(this, 0, intent, 0); 422 423 } else { 424 replyActionPendingIntent = mainPendingIntent; 425 } 426 427 NotificationCompat.Action replyAction = 428 new NotificationCompat.Action.Builder( 429 R.drawable.ic_reply_white_18dp, 430 replyLabel, 431 replyActionPendingIntent) 432 .addRemoteInput(remoteInput) 433 .build(); 434 435 // 4. Build and issue the notification 436 437 // Because we want this to be a new notification (not updating a previous notification), we 438 // create a new Builder. Later, we use the same global builder to get back the notification 439 // we built here for a comment on the post. 440 441 NotificationCompat.Builder notificationCompatBuilder = 442 new NotificationCompat.Builder(getApplicationContext()); 443 444 GlobalNotificationBuilder.setNotificationCompatBuilderInstance(notificationCompatBuilder); 445 446 // 4. Build and issue the notification 447 notificationCompatBuilder 448 // BIG_PICTURE_STYLE sets title and content for API 16 (4.1 and after) 449 .setStyle(bigPictureStyle) 450 // Title for API <16 (4.0 and below) devices 451 .setContentTitle(bigPictureStyleSocialAppData.getContentTitle()) 452 // Content for API <24 (7.0 and below) devices 453 .setContentText(bigPictureStyleSocialAppData.getContentText()) 454 .setSmallIcon(R.drawable.ic_launcher) 455 .setLargeIcon(BitmapFactory.decodeResource( 456 getResources(), 457 R.drawable.ic_person_black_48dp)) 458 .setContentIntent(mainPendingIntent) 459 // Set primary color (important for Wear 2.0 Notifications) 460 .setColor(getResources().getColor(R.color.colorPrimary)) 461 462 // SIDE NOTE: Auto-bundling is enabled for 4 or more notifications on API 24+ (N+) 463 // devices and all Android Wear devices. If you have more than one notification and 464 // you prefer a different summary notification, set a group key and create a 465 // summary notification via 466 // .setGroupSummary(true) 467 // .setGroup(GROUP_KEY_YOUR_NAME_HERE) 468 469 .setSubText(Integer.toString(1)) 470 .addAction(replyAction) 471 .setCategory(Notification.CATEGORY_SOCIAL) 472 .setPriority(Notification.PRIORITY_HIGH) 473 474 // Hides content on the lock-screen 475 .setVisibility(Notification.VISIBILITY_PRIVATE); 476 477 // If the phone is in "Do not disturb mode, the user will still be notified if 478 // the sender(s) is starred as a favorite. 479 for (String name : bigPictureStyleSocialAppData.getParticipants()) { 480 notificationCompatBuilder.addPerson(name); 481 } 482 483 Notification notification = notificationCompatBuilder.build(); 484 485 mNotificationManagerCompat.notify(NOTIFICATION_ID, notification); 486 } 487 488 /* 489 * Generates a INBOX_STYLE Notification that supports both phone/tablet and wear. For devices 490 * on API level 16 (4.1.x - Jelly Bean) and after, displays INBOX_STYLE. Otherwise, displays a 491 * basic notification. 492 */ 493 private void generateInboxStyleNotification() { 494 495 Log.d(TAG, "generateInboxStyleNotification()"); 496 497 498 // Main steps for building a INBOX_STYLE notification: 499 // 0. Get your data 500 // 1. Build the INBOX_STYLE 501 // 2. Set up main Intent for notification 502 // 3. Build and issue the notification 503 504 // 0. Get your data (everything unique per Notification) 505 MockDatabase.InboxStyleEmailAppData inboxStyleEmailAppData = 506 MockDatabase.getInboxStyleData(); 507 508 // 1. Build the INBOX_STYLE 509 InboxStyle inboxStyle = new NotificationCompat.InboxStyle() 510 // This title is slightly different than regular title, since I know INBOX_STYLE is 511 // available. 512 .setBigContentTitle(inboxStyleEmailAppData.getBigContentTitle()) 513 .setSummaryText(inboxStyleEmailAppData.getSummaryText()); 514 515 // Add each summary line of the new emails, you can add up to 5 516 for (String summary : inboxStyleEmailAppData.getIndividualEmailSummary()) { 517 inboxStyle.addLine(summary); 518 } 519 520 // 2. Set up main Intent for notification 521 Intent mainIntent = new Intent(this, InboxMainActivity.class); 522 523 // When creating your Intent, you need to take into account the back state, i.e., what 524 // happens after your Activity launches and the user presses the back button. 525 526 // There are two options: 527 // 1. Regular activity - You're starting an Activity that's part of the application's 528 // normal workflow. 529 530 // 2. Special activity - The user only sees this Activity if it's started from a 531 // notification. In a sense, the Activity extends the notification by providing 532 // information that would be hard to display in the notification itself. 533 534 // Even though this sample's MainActivity doesn't link to the Activity this Notification 535 // launches directly, i.e., it isn't part of the normal workflow, a eamil app generally 536 // always links to individual emails as part of the app flow, so we will follow option 1. 537 538 // For an example of option 2, check out the BIG_TEXT_STYLE example. 539 540 // For more information, check out our dev article: 541 // https://developer.android.com/training/notify-user/navigation.html 542 543 TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); 544 // Adds the back stack 545 stackBuilder.addParentStack(InboxMainActivity.class); 546 // Adds the Intent to the top of the stack 547 stackBuilder.addNextIntent(mainIntent); 548 // Gets a PendingIntent containing the entire back stack 549 PendingIntent mainPendingIntent = 550 PendingIntent.getActivity( 551 this, 552 0, 553 mainIntent, 554 PendingIntent.FLAG_UPDATE_CURRENT 555 ); 556 557 // 3. Build and issue the notification 558 559 // Because we want this to be a new notification (not updating a previous notification), we 560 // create a new Builder. However, we don't need to update this notification later, so we 561 // will not need to set a global builder for access to the notification later. 562 563 NotificationCompat.Builder notificationCompatBuilder = 564 new NotificationCompat.Builder(getApplicationContext()); 565 566 GlobalNotificationBuilder.setNotificationCompatBuilderInstance(notificationCompatBuilder); 567 568 // 4. Build and issue the notification 569 notificationCompatBuilder 570 571 // INBOX_STYLE sets title and content for API 16+ (4.1 and after) when the 572 // notification is expanded 573 .setStyle(inboxStyle) 574 575 // Title for API <16 (4.0 and below) devices and API 16+ (4.1 and after) when the 576 // notification is collapsed 577 .setContentTitle(inboxStyleEmailAppData.getContentTitle()) 578 579 // Content for API <24 (7.0 and below) devices and API 16+ (4.1 and after) when the 580 // notification is collapsed 581 .setContentText(inboxStyleEmailAppData.getContentText()) 582 .setSmallIcon(R.drawable.ic_launcher) 583 .setLargeIcon(BitmapFactory.decodeResource( 584 getResources(), 585 R.drawable.ic_person_black_48dp)) 586 .setContentIntent(mainPendingIntent) 587 // Set primary color (important for Wear 2.0 Notifications) 588 .setColor(getResources().getColor(R.color.colorPrimary)) 589 590 // SIDE NOTE: Auto-bundling is enabled for 4 or more notifications on API 24+ (N+) 591 // devices and all Android Wear devices. If you have more than one notification and 592 // you prefer a different summary notification, set a group key and create a 593 // summary notification via 594 // .setGroupSummary(true) 595 // .setGroup(GROUP_KEY_YOUR_NAME_HERE) 596 597 // Sets large number at the right-hand side of the notification for API <24 devices 598 .setSubText(Integer.toString(inboxStyleEmailAppData.getNumberOfNewEmails())) 599 600 .setCategory(Notification.CATEGORY_EMAIL) 601 .setPriority(Notification.PRIORITY_HIGH) 602 603 // Hides content on the lock-screen 604 .setVisibility(Notification.VISIBILITY_PRIVATE); 605 606 // If the phone is in "Do not disturb mode, the user will still be notified if 607 // the sender(s) is starred as a favorite. 608 for (String name : inboxStyleEmailAppData.getParticipants()) { 609 notificationCompatBuilder.addPerson(name); 610 } 611 612 Notification notification = notificationCompatBuilder.build(); 613 614 mNotificationManagerCompat.notify(NOTIFICATION_ID, notification); 615 } 616 617 /* 618 * Generates a MESSAGING_STYLE Notification that supports both phone/tablet and wear. For 619 * devices on API level 24 (7.0 - Nougat) and after, displays MESSAGING_STYLE. Otherwise, 620 * displays a basic BIG_TEXT_STYLE. 621 */ 622 private void generateMessagingStyleNotification() { 623 624 Log.d(TAG, "generateMessagingStyleNotification()"); 625 626 // Main steps for building a MESSAGING_STYLE notification: 627 // 0. Get your data 628 // 1. Build the MESSAGING_STYLE 629 // 2. Add support for Wear 1.+ 630 // 3. Set up main Intent for notification 631 // 4. Set up RemoteInput (users can input directly from notification) 632 // 5. Build and issue the notification 633 634 // 0. Get your data (everything unique per Notification) 635 MockDatabase.MessagingStyleCommsAppData messagingStyleCommsAppData = 636 MockDatabase.getMessagingStyleData(); 637 638 // 1. Build the Notification.Style (MESSAGING_STYLE) 639 String contentTitle = messagingStyleCommsAppData.getContentTitle(); 640 641 MessagingStyle messagingStyle = 642 new NotificationCompat.MessagingStyle(messagingStyleCommsAppData.getReplayName()) 643 // You could set a different title to appear when the messaging style 644 // is supported on device (24+) if you wish. In our case, we use the same 645 // title. 646 .setConversationTitle(contentTitle); 647 648 // Adds all Messages 649 // Note: Messages include the text, timestamp, and sender 650 for (MessagingStyle.Message message : messagingStyleCommsAppData.getMessages()) { 651 messagingStyle.addMessage(message); 652 } 653 654 655 // 2. Add support for Wear 1.+ 656 657 // Since Wear 1.0 doesn't support the MESSAGING_STYLE, we use the BIG_TEXT_STYLE, so all the 658 // text is visible. 659 660 // This is basically a toString() of all the Messages above. 661 String fullMessageForWearVersion1 = messagingStyleCommsAppData.getFullConversation(); 662 663 Notification chatHistoryForWearV1 = new NotificationCompat.Builder(getApplicationContext()) 664 .setStyle(new BigTextStyle().bigText(fullMessageForWearVersion1)) 665 .setContentTitle(contentTitle) 666 .setSmallIcon(R.drawable.ic_launcher) 667 .setContentText(fullMessageForWearVersion1) 668 .build(); 669 670 // Adds page with all text to support Wear 1.+. 671 NotificationCompat.WearableExtender wearableExtenderForWearVersion1 = 672 new NotificationCompat.WearableExtender() 673 .addPage(chatHistoryForWearV1); 674 675 676 677 // 3. Set up main Intent for notification 678 Intent notifyIntent = new Intent(this, MessagingMainActivity.class); 679 680 // When creating your Intent, you need to take into account the back state, i.e., what 681 // happens after your Activity launches and the user presses the back button. 682 683 // There are two options: 684 // 1. Regular activity - You're starting an Activity that's part of the application's 685 // normal workflow. 686 687 // 2. Special activity - The user only sees this Activity if it's started from a 688 // notification. In a sense, the Activity extends the notification by providing 689 // information that would be hard to display in the notification itself. 690 691 // Even though this sample's MainActivity doesn't link to the Activity this Notification 692 // launches directly, i.e., it isn't part of the normal workflow, a chat app generally 693 // always links to individual conversations as part of the app flow, so we will follow 694 // option 1. 695 696 // For an example of option 2, check out the BIG_TEXT_STYLE example. 697 698 // For more information, check out our dev article: 699 // https://developer.android.com/training/notify-user/navigation.html 700 701 TaskStackBuilder stackBuilder = TaskStackBuilder.create(this); 702 // Adds the back stack 703 stackBuilder.addParentStack(MessagingMainActivity.class); 704 // Adds the Intent to the top of the stack 705 stackBuilder.addNextIntent(notifyIntent); 706 // Gets a PendingIntent containing the entire back stack 707 PendingIntent mainPendingIntent = 708 PendingIntent.getActivity( 709 this, 710 0, 711 notifyIntent, 712 PendingIntent.FLAG_UPDATE_CURRENT 713 ); 714 715 716 // 4. Set up RemoteInput, so users can input (keyboard and voice) from notification 717 718 // Note: For API <24 (M and below) we need to use an Activity, so the lock-screen present 719 // the auth challenge. For API 24+ (N and above), we use a Service (could be a 720 // BroadcastReceiver), so the user can input from Notification or lock-screen (they have 721 // choice to allow) without leaving the notification. 722 723 // Create the RemoteInput specifying this key 724 String replyLabel = getString(R.string.reply_label); 725 RemoteInput remoteInput = new RemoteInput.Builder(MessagingIntentService.EXTRA_REPLY) 726 .setLabel(replyLabel) 727 .build(); 728 729 // Pending intent = 730 // API <24 (M and below): activity so the lock-screen presents the auth challenge 731 // API 24+ (N and above): this should be a Service or BroadcastReceiver 732 PendingIntent replyActionPendingIntent; 733 734 if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.N) { 735 Intent intent = new Intent(this, MessagingIntentService.class); 736 intent.setAction(MessagingIntentService.ACTION_REPLY); 737 replyActionPendingIntent = PendingIntent.getService(this, 0, intent, 0); 738 739 } else { 740 replyActionPendingIntent = mainPendingIntent; 741 } 742 743 NotificationCompat.Action replyAction = 744 new NotificationCompat.Action.Builder( 745 R.drawable.ic_reply_white_18dp, 746 replyLabel, 747 replyActionPendingIntent) 748 .addRemoteInput(remoteInput) 749 // Allows system to generate replies by context of conversation 750 .setAllowGeneratedReplies(true) 751 .build(); 752 753 754 // 5. Build and issue the notification 755 756 // Because we want this to be a new notification (not updating current notification), we 757 // create a new Builder. Later, we update this same notification, so we need to save this 758 // Builder globally (as outlined earlier). 759 760 NotificationCompat.Builder notificationCompatBuilder = 761 new NotificationCompat.Builder(getApplicationContext()); 762 763 GlobalNotificationBuilder.setNotificationCompatBuilderInstance(notificationCompatBuilder); 764 765 // Builds and issues notification 766 notificationCompatBuilder 767 // MESSAGING_STYLE sets title and content for API 24+ (N and above) devices 768 .setStyle(messagingStyle) 769 // Title for API <24 (M and below) devices 770 .setContentTitle(contentTitle) 771 // Content for API <24 (M and below) devices 772 .setContentText(messagingStyleCommsAppData.getContentText()) 773 .setSmallIcon(R.drawable.ic_launcher) 774 .setLargeIcon(BitmapFactory.decodeResource( 775 getResources(), 776 R.drawable.ic_person_black_48dp)) 777 .setContentIntent(mainPendingIntent) 778 // Set primary color (important for Wear 2.0 Notifications) 779 .setColor(getResources().getColor(R.color.colorPrimary)) 780 781 // SIDE NOTE: Auto-bundling is enabled for 4 or more notifications on API 24+ (N+) 782 // devices and all Android Wear devices. If you have more than one notification and 783 // you prefer a different summary notification, set a group key and create a 784 // summary notification via 785 // .setGroupSummary(true) 786 // .setGroup(GROUP_KEY_YOUR_NAME_HERE) 787 788 // Number of new notifications for API <24 (M and below) devices 789 .setSubText(Integer.toString(messagingStyleCommsAppData.getNumberOfNewMessages())) 790 791 .addAction(replyAction) 792 .setCategory(Notification.CATEGORY_MESSAGE) 793 .setPriority(Notification.PRIORITY_HIGH) 794 795 // Hides content on the lock-screen 796 .setVisibility(Notification.VISIBILITY_PRIVATE) 797 798 // Adds multiple pages for easy consumption on a wear device. 799 .extend(wearableExtenderForWearVersion1); 800 801 // If the phone is in "Do not disturb mode, the user will still be notified if 802 // the sender(s) is starred as a favorite. 803 for (String name : messagingStyleCommsAppData.getParticipants()) { 804 notificationCompatBuilder.addPerson(name); 805 } 806 807 Notification notification = notificationCompatBuilder.build(); 808 mNotificationManagerCompat.notify(NOTIFICATION_ID, notification); 809 } 810 811 /** 812 * Helper method for the SnackBar action, i.e., if the user has this application's notifications 813 * disabled, this opens up the dialog to turn them back on after the user requests a 814 * Notification launch. 815 * 816 * IMPORTANT NOTE: You should not do this action unless the user takes an action to see your 817 * Notifications like this sample demonstrates. Spamming users to re-enable your notifications 818 * is a bad idea. 819 */ 820 private void openNotificationSettingsForApp() { 821 // Links to this app's notification settings 822 Intent intent = new Intent(); 823 intent.setAction("android.settings.APP_NOTIFICATION_SETTINGS"); 824 intent.putExtra("app_package", getPackageName()); 825 intent.putExtra("app_uid", getApplicationInfo().uid); 826 startActivity(intent); 827 } 828 }