1 <html devsite> 2 <head> 3 <title>Call Notifications</title> 4 <meta name="project_path" value="/_project.yaml" /> 5 <meta name="book_path" value="/_book.yaml" /> 6 </head> 7 <body> 8 <!-- 9 Copyright 2017 The Android Open Source Project 10 11 Licensed under the Apache License, Version 2.0 (the "License"); 12 you may not use this file except in compliance with the License. 13 You may obtain a copy of the License at 14 15 http://www.apache.org/licenses/LICENSE-2.0 16 17 Unless required by applicable law or agreed to in writing, software 18 distributed under the License is distributed on an "AS IS" BASIS, 19 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 20 See the License for the specific language governing permissions and 21 limitations under the License. 22 --> 23 24 25 26 <p>Android 7.0 moves functionality related to call notifications from the 27 Telecom system service in the Android platform to the Dialer application. 28 Previously, the responsibility for displaying call-related notifications was 29 split between Telecom and the default Dialer app, creating inconsistencies in 30 behavior. In Android 7.0, the Dialer assumes all responsibility for handling 31 call notifications.</p> 32 33 <h2 id=android_6>Behavior in Android 6.x and earlier</h2> 34 <p>In earlier Android releases, Telecom and Dialer split responsibilities as 35 described below:</p> 36 37 <table> 38 <tr> 39 <th>Functionality</th> 40 <th>Done by Telecom</th> 41 <th>Done by Dialer</th> 42 </tr> 43 44 <tr> 45 <td>Incoming call notification</td> 46 <td>Yes (ringing, vibrate)</td> 47 <td>Yes (notification display, caller ID)</td> 48 </tr> 49 50 <tr> 51 <td>Send to voicemail</td> 52 <td>Yes</td> 53 <td>No</td> 54 </tr> 55 56 <tr> 57 <td>Custom ringtone</td> 58 <td>Yes</td> 59 <td>No</td> 60 </tr> 61 62 <tr> 63 <td>Missed call notifications</td> 64 <td>Yes</td> 65 <td>No</td> 66 </tr> 67 68 <tr> 69 <td>Message Waiting Indicator (call voicemail)</td> 70 <td>Yes (telephony)</td> 71 <td>No</td> 72 </tr> 73 74 <tr> 75 <td>Visual voicemail notifications</td> 76 <td>No</td> 77 <td>Yes</td> 78 </tr> 79 80 </tbody> 81 </table> 82 83 <p>Examples of inconsistent behavior caused by this responsibility split 84 included:</p> 85 <ul> 86 <li>Telecom was responsible for starting the ringer/vibrator, but the dialer was 87 responsible for displaying the incoming call notification. If the dialer is slow 88 to startup, this can result in ringing starting several seconds before the 89 incoming call notification is displayed.</li> 90 <li>Telecom was responsible for displaying missed call notifications. As 91 proprietary features (such as Google caller ID) do not work on these 92 notifications, this could result in inconsistencies between Telecom 93 notifications and Dialer UI (such as the call log).</li> 94 </ul> 95 96 <h2 id=android_7>Behavior in Android 7.0 and later</h2> 97 <p>The Android Open Source Project (AOSP) Dialer implements the new 98 functionality. For details, refer to the following documentation:</p> 99 <ul> 100 <li>Missed call notifications<br> 101 <a href="https://android.googlesource.com/platform/packages/services/Telecomm/+/nougat-release/src/com/android/server/telecom/ui/MissedCallNotifierImpl.java">Telecom/src/com/android/server/telecom/ui/MissedCallNotifierImpl.java</a><br> 102 <a href="https://android.googlesource.com/platform/packages/apps/Dialer/+/nougat-release/src/com/android/dialer/calllog/MissedCallNotificationReceiver.java">Dialer/src/com/android/dialer/calllog/MissedCallNotificationReceiver.java</a><br> 103 <a href="https://android.googlesource.com/platform/packages/apps/Dialer/+/nougat-release/src/com/android/dialer/calllog/MissedCallNotifier.java">Dialer/src/com/android/dialer/calllog/MissedCallNotifier.java</a></li> 104 <li>Playing ringtones:<br> 105 <a href="https://android.googlesource.com/platform/frameworks/base/+/nougat-release/telecomm/java/android/telecom/InCallService.java">frameworks/base/telecomm/java/android/telecom/InCallService.java</a><br> 106 <a href="https://android.googlesource.com/platform/packages/services/Telecomm/+/nougat-release/src/com/android/server/telecom/InCallController.java">Telecom/src/com/android/server/telecom/InCallController.java</a><br> 107 <a href="https://android.googlesource.com/platform/packages/apps/Dialer/+/nougat-release/InCallUI/src/com/android/incallui/ringtone/">Dialer/InCallUI/src/com/android/incallui/ringtone</a><br> 108 <a href="https://android.googlesource.com/platform/packages/apps/Dialer/+/nougat-release/InCallUI/src/com/android/incallui/StatusBarNotifier.java">Dialer/InCallUI/src/com/android/incallui/StatusBarNotifier.java</a></li> 109 <li>VVM notifications<br> 110 <a href="https://android.googlesource.com/platform/frameworks/base/+/nougat-release/telephony/java/android/telephony/TelephonyManager.java">frameworks/base/telephony/java/android/telephony/TelephonyManager.java</a><br> 111 <a href="https://android.googlesource.com/platform/packages/services/Telephony/+/nougat-release/src/com/android/phone/PhoneInterfaceManager.java">Telephony/src/com/android/phone/PhoneInterfaceManager.java</a><br> 112 <a href="https://android.googlesource.com/platform/packages/apps/Dialer/+/nougat-release/src/com/android/dialer/calllog/DefaultVoicemailNotifier.java">Dialer/src/com/android/dialer/calllog/DefaultVoicemailNotifier.java</a></li> 113 </ul> 114 115 <h2 id=implement>Implementation</h2> 116 <p>Device implementers may need to update Telecom/Telephony components that 117 expose APIs available for use by by the default Dialer.</p> 118 119 </body> 120 </html> 121
