page.title=Call Notifications
@jd:body

<!--
    Copyright 2016 The Android Open Source Project

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

        http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-->
<div id="qv-wrapper">
  <div id="qv">
    <h2>In this document</h2>
    <ol id="auto-toc">
    </ol>
  </div>
</div>

<p>Android 7.0 moves functionality related to call notifications from the
Telecom system service in the Android platform to the Dialer application.
Previously, the responsibility for displaying call-related notifications was
split between Telecom and the default Dialer app, creating inconsistencies in
behavior. In Android 7.0, the Dialer assumes all responsibility for handling
call notifications.</p>

<h2 id=android_6>Behavior in Android 6.x and earlier</h2>
<p>In earlier Android releases, Telecom and Dialer split responsibilities as
described below:</p>

<table>
<tr>
<th>Functionality</th>
<th>Done by Telecom</th>
<th>Done by Dialer</th>
</tr>

<tr>
<td>Incoming call notification</td>
<td>Yes (ringing, vibrate)</td>
<td>Yes (notification display, caller ID)</td>
</tr>

<tr>
<td>Send to voicemail</td>
<td>Yes</td>
<td>No</td>
</tr>

<tr>
<td>Custom ringtone</td>
<td>Yes</td>
<td>No</td>
</tr>

<tr>
<td>Missed call notifications</td>
<td>Yes</td>
<td>No</td>
</tr>

<tr>
<td>Message Waiting Indicator (call voicemail)</td>
<td>Yes (telephony)</td>
<td>No</td>
</tr>

<tr>
<td>Visual voicemail notifications</td>
<td>No</td>
<td>Yes</td>
</tr>

</tbody>
</table>

<p>Examples of inconsistent behavior caused by this responsibility split
included:</p>
<ul>
<li>Telecom was responsible for starting the ringer/vibrator, but the dialer was
responsible for displaying the incoming call notification. If the dialer is slow
to startup, this can result in ringing starting several seconds before the
incoming call notification is displayed.</li>
<li>Telecom was responsible for displaying missed call notifications. As
proprietary features (such as Google caller ID) do not work on these
notifications, this could result in inconsistencies between Telecom
notifications and Dialer UI (such as the call log).</li>
</ul>

<h2 id=android_7>Behavior in Android 7.0 and later</h2>
<p>The Android Open Source Project (AOSP) Dialer implements the new
functionality. For details, refer to the following documentation:</p>
<ul>
<li>Missed call notifications<br>
<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>
<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>
<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>
<li>Playing ringtones:<br>
<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>
<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>
<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>
<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>
<li>VVM notifications<br>
<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>
<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>
<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>
</ul>

<h2 id=implement>Implementation</h2>
<p>Device implementers may need to update Telecom/Telephony components that
expose APIs available for use by by the default Dialer.</p>