/* * Copyright (C) 2011 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. */ package com.android.dialer.calllogutils; import android.content.Context; import android.content.res.Resources; import android.net.Uri; import android.provider.CallLog; import android.provider.CallLog.Calls; import android.support.annotation.Nullable; import android.telecom.PhoneAccountHandle; import android.text.TextUtils; import com.android.contacts.common.ContactsUtils.UserType; import com.android.contacts.common.util.ContactDisplayUtils; import com.android.dialer.contacts.displaypreference.ContactDisplayPreferences.DisplayOrder; import com.android.dialer.logging.ContactSource; import com.android.dialer.phonenumbercache.ContactInfo; /** The details of a phone call to be shown in the UI. */ public class PhoneCallDetails { // The number of the other party involved in the call. public CharSequence number; // Post-dial digits associated with the outgoing call. public String postDialDigits; // The secondary line number the call was received via. public String viaNumber; // The number presenting rules set by the network, e.g., {@link Calls#PRESENTATION_ALLOWED} public int numberPresentation; // The country corresponding with the phone number. public String countryIso; // The geocoded location for the phone number. public String geocode; /** * The type of calls, as defined in the call log table, e.g., {@link Calls#INCOMING_TYPE}. * *
There might be multiple types if this represents a set of entries grouped together. */ public int[] callTypes; // The date of the call, in milliseconds since the epoch. public long date; // The duration of the call in milliseconds, or 0 for missed calls. public long duration; // The name of the contact, or the empty string. public CharSequence namePrimary; // The alternative name of the contact, e.g. last name first, or the empty string public CharSequence nameAlternative; /** * The user's preference on name display order, last name first or first time first. {@see * ContactsPreferences} */ public DisplayOrder nameDisplayOrder; // The type of phone, e.g., {@link Phone#TYPE_HOME}, 0 if not available. public int numberType; // The custom label associated with the phone number in the contact, or the empty string. public CharSequence numberLabel; // The URI of the contact associated with this phone call. public Uri contactUri; /** * The photo URI of the picture of the contact that is associated with this phone call or null if * there is none. * *
This is meant to store the high-res photo only. */ public Uri photoUri; // The source type of the contact associated with this call. public ContactSource.Type sourceType; // The object id type of the contact associated with this call. public String objectId; // The unique identifier for the account associated with the call. public PhoneAccountHandle accountHandle; // Features applicable to this call. public int features; // Total data usage for this call. public Long dataUsage; // Voicemail transcription public String transcription; // Voicemail transcription state, ie. in-progress, failed, etc. public int transcriptionState; // The display string for the number. public String displayNumber; // Whether the contact number is a voicemail number. public boolean isVoicemail; /** The {@link UserType} of the contact */ public @UserType long contactUserType; /** * If this is a voicemail, whether the message is read. For other types of calls, this defaults to * {@code true}. */ public boolean isRead = true; // If this call is a spam number. public boolean isSpam = false; // If this call is a blocked number. public boolean isBlocked = false; // Call location and date text. public CharSequence callLocationAndDate; // Call description. public CharSequence callDescription; public String accountComponentName; public String accountId; public ContactInfo cachedContactInfo; public int voicemailId; public int previousGroup; // The URI of the voicemail associated with this phone call, if this call went to voicemail. public String voicemailUri; /** * Constructor with required fields for the details of a call with a number associated with a * contact. */ public PhoneCallDetails( CharSequence number, int numberPresentation, CharSequence postDialDigits) { this.number = number; this.numberPresentation = numberPresentation; this.postDialDigits = postDialDigits.toString(); } /** * Construct the "on {accountLabel} via {viaNumber}" accessibility description for the account * list item, depending on the existence of the accountLabel and viaNumber. * * @param viaNumber The number that this call is being placed via. * @param accountLabel The {@link PhoneAccount} label that this call is being placed with. * @return The description of the account that this call has been placed on. */ public static CharSequence createAccountLabelDescription( Resources resources, @Nullable String viaNumber, @Nullable CharSequence accountLabel) { if ((!TextUtils.isEmpty(viaNumber)) && !TextUtils.isEmpty(accountLabel)) { String msg = resources.getString( R.string.description_via_number_phone_account, accountLabel, viaNumber); CharSequence accountNumberLabel = ContactDisplayUtils.getTelephoneTtsSpannable(msg, viaNumber); return (accountNumberLabel == null) ? msg : accountNumberLabel; } else if (!TextUtils.isEmpty(viaNumber)) { CharSequence viaNumberLabel = ContactDisplayUtils.getTtsSpannedPhoneNumber( resources, R.string.description_via_number, viaNumber); return (viaNumberLabel == null) ? viaNumber : viaNumberLabel; } else if (!TextUtils.isEmpty(accountLabel)) { return TextUtils.expandTemplate( resources.getString(R.string.description_phone_account), accountLabel); } return ""; } /** * Returns the preferred name for the call details as specified by the {@link #nameDisplayOrder} * * @return the preferred name */ public CharSequence getPreferredName() { if (nameDisplayOrder == DisplayOrder.PRIMARY || TextUtils.isEmpty(nameAlternative)) { return namePrimary; } return nameAlternative; } public void updateDisplayNumber( Context context, CharSequence formattedNumber, boolean isVoicemail) { displayNumber = PhoneNumberDisplayUtil.getDisplayNumber( context, number, numberPresentation, formattedNumber, postDialDigits, isVoicemail) .toString(); } public boolean hasIncomingCalls() { for (int i = 0; i < callTypes.length; i++) { if (callTypes[i] == CallLog.Calls.INCOMING_TYPE || callTypes[i] == CallLog.Calls.MISSED_TYPE || callTypes[i] == CallLog.Calls.VOICEMAIL_TYPE || callTypes[i] == CallLog.Calls.REJECTED_TYPE || callTypes[i] == CallLog.Calls.BLOCKED_TYPE) { return true; } } return false; } }