/* * Copyright (C) 2018 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.historyitemactions; import android.content.Context; import android.content.Intent; import android.net.Uri; import android.provider.CallLog.Calls; import android.provider.ContactsContract; import android.text.TextUtils; import com.android.dialer.blockreportspam.BlockReportSpamDialogInfo; import com.android.dialer.callintent.CallInitiationType; import com.android.dialer.callintent.CallIntentBuilder; import com.android.dialer.clipboard.ClipboardUtils; import com.android.dialer.common.Assert; import com.android.dialer.duo.Duo; import com.android.dialer.duo.DuoComponent; import com.android.dialer.logging.ReportingLocation; import com.android.dialer.util.CallUtil; import com.android.dialer.util.UriUtils; import java.util.ArrayList; import java.util.List; /** * Builds a list of {@link HistoryItemActionModule HistoryItemActionModules}. * *
Example usage: * *
* // Create a HistoryItemActionModuleInfo proto with the information you have.
* // You can simply skip a field if there is no information for it.
* HistoryItemActionModuleInfo moduleInfo =
* HistoryItemActionModuleInfo.newBuilder()
* .setNormalizedNumber("+16502530000")
* .setCountryIso("US")
* .setName("Google")
* .build();
*
* // Initialize the builder using the module info above.
* // Note that some modules require an activity context to work so it is preferred to pass one
* // instead of an application context to the builder.
* HistoryItemActionModulesBuilder modulesBuilder =
* new HistoryItemActionModulesBuilder(activityContext, moduleInfo);
*
* // Add all modules you want in the order you like.
* // If a module shouldn't be added according to the module info, it won't be.
* // For example, if the module info is not for a video call and doesn't indicate the presence
* // of video calling capabilities, calling addModuleForVideoCall() is a no-op.
* modulesBuilder
* .addModuleForVoiceCall()
* .addModuleForVideoCall()
* .addModuleForSendingTextMessage()
* .addModuleForDivider()
* .addModuleForAddingToContacts()
* .addModuleForBlockedOrSpamNumber()
* .addModuleForCopyingNumber();
*
* List modules = modulesBuilder.build();
*
*/
public final class HistoryItemActionModulesBuilder {
private final Context context;
private final HistoryItemActionModuleInfo moduleInfo;
private final ListThe method is a no-op if the number is blocked. */ public HistoryItemActionModulesBuilder addModuleForVoiceCall() { if (moduleInfo.getIsBlocked()) { return this; } // TODO(zachh): Support post-dial digits; consider using DialerPhoneNumber. // Do not set PhoneAccountHandle so that regular PreCall logic will be used. The account used to // place or receive the call should be ignored for voice calls. CallIntentBuilder callIntentBuilder = new CallIntentBuilder(moduleInfo.getNormalizedNumber(), getCallInitiationType()) .setAllowAssistedDial(moduleInfo.getCanSupportAssistedDialing()); modules.add(IntentModule.newCallModule(context, callIntentBuilder)); return this; } /** * Adds a module for a carrier video call *or* a Duo video call. * *
This method is a no-op if * *
If the provided module info is for a Duo video call and Duo is available, add a Duo video * call module. * *
If the provided module info is for a Duo video call but Duo is unavailable, add a carrier * video call module. * *
If the provided module info is for a carrier video call, add a carrier video call module. * *
If the provided module info is for a voice call and the device has carrier video call * capability, add a carrier video call module. * *
If the provided module info is for a voice call, the device doesn't have carrier video call * capability, and Duo is available, add a Duo video call module. */ public HistoryItemActionModulesBuilder addModuleForVideoCall() { if (moduleInfo.getIsVoicemailCall() || moduleInfo.getIsBlocked() || moduleInfo.getIsSpam()) { return this; } // Do not set PhoneAccountHandle so that regular PreCall logic will be used. The account used to // place or receive the call should be ignored for carrier video calls. // TODO(a bug): figure out the correct video call behavior HistoryItemActionModule carrierVideoCallModule = IntentModule.newCallModule( context, new CallIntentBuilder(moduleInfo.getNormalizedNumber(), getCallInitiationType()) .setAllowAssistedDial(moduleInfo.getCanSupportAssistedDialing()) .setIsVideoCall(true)); HistoryItemActionModule duoVideoCallModule = new DuoCallModule(context, moduleInfo.getNormalizedNumber()); // If the module info is for a video call, add an appropriate video call module. if ((moduleInfo.getFeatures() & Calls.FEATURES_VIDEO) == Calls.FEATURES_VIDEO) { modules.add(isDuoCall() && canPlaceDuoCall() ? duoVideoCallModule : carrierVideoCallModule); return this; } // At this point, the module info is for an audio call. We will also add a video call module if // the video capability is present. // // The carrier video call module takes precedence over the Duo module. if (canPlaceCarrierVideoCall()) { modules.add(carrierVideoCallModule); } else if (canPlaceDuoCall()) { modules.add(duoVideoCallModule); } return this; } /** * Adds a module for sending text messages. * *
The method is a no-op if * *
The method is a no-op if the divider module will be the first module. */ public HistoryItemActionModulesBuilder addModuleForDivider() { if (modules.isEmpty()) { return this; } modules.add(new DividerModule()); return this; } /** * Adds a module for adding a number to Contacts. * *
The method is a no-op if * *
The method is a no-op if the call is one made to a voicemail box. * *
If a number is marked as spam, add two modules: * *
If a number is blocked but not marked as spam, add the "Unblock" module. * *
If a number is not blocked or marked as spam, add the "Block/Report spam" module. */ public HistoryItemActionModulesBuilder addModuleForBlockedOrSpamNumber() { if (moduleInfo.getIsVoicemailCall()) { return this; } BlockReportSpamDialogInfo blockReportSpamDialogInfo = BlockReportSpamDialogInfo.newBuilder() .setNormalizedNumber(moduleInfo.getNormalizedNumber()) .setCountryIso(moduleInfo.getCountryIso()) .setCallType(moduleInfo.getCallType()) .setReportingLocation(getReportingLocation()) .setContactSource(moduleInfo.getContactSource()) .build(); // For a spam number, add two modules: // (1) "Not spam" and "Block", or // (2) "Not spam" and "Unblock". if (moduleInfo.getIsSpam()) { modules.add( BlockReportSpamModules.moduleForMarkingNumberAsNotSpam( context, blockReportSpamDialogInfo)); modules.add( moduleInfo.getIsBlocked() ? BlockReportSpamModules.moduleForUnblockingNumber(context, blockReportSpamDialogInfo) : BlockReportSpamModules.moduleForBlockingNumber(context, blockReportSpamDialogInfo)); return this; } // For a blocked non-spam number, add the "Unblock" module. if (moduleInfo.getIsBlocked()) { modules.add( BlockReportSpamModules.moduleForUnblockingNumber(context, blockReportSpamDialogInfo)); return this; } // For a number that is neither a spam number nor blocked, add the "Block/Report spam" module. modules.add( BlockReportSpamModules.moduleForBlockingNumberAndOptionallyReportingSpam( context, blockReportSpamDialogInfo)); return this; } /** * Adds a module for copying a number. * *
The method is a no-op if the number is empty. */ public HistoryItemActionModulesBuilder addModuleForCopyingNumber() { if (TextUtils.isEmpty(moduleInfo.getNormalizedNumber())) { return this; } modules.add( new HistoryItemActionModule() { @Override public int getStringId() { return R.string.copy_number; } @Override public int getDrawableId() { return R.drawable.quantum_ic_content_copy_vd_theme_24; } @Override public boolean onClick() { ClipboardUtils.copyText( context, /* label = */ null, moduleInfo.getNormalizedNumber(), /* showToast = */ true); return false; } }); return this; } private boolean canPlaceCarrierVideoCall() { int carrierVideoAvailability = CallUtil.getVideoCallingAvailability(context); boolean isCarrierVideoCallingEnabled = ((carrierVideoAvailability & CallUtil.VIDEO_CALLING_ENABLED) == CallUtil.VIDEO_CALLING_ENABLED); boolean canRelyOnCarrierVideoPresence = ((carrierVideoAvailability & CallUtil.VIDEO_CALLING_PRESENCE) == CallUtil.VIDEO_CALLING_PRESENCE); return isCarrierVideoCallingEnabled && canRelyOnCarrierVideoPresence && moduleInfo.getCanSupportCarrierVideoCall(); } private boolean isDuoCall() { return DuoComponent.get(context) .getDuo() .isDuoAccount(moduleInfo.getPhoneAccountComponentName()); } private boolean canPlaceDuoCall() { Duo duo = DuoComponent.get(context).getDuo(); return duo.isInstalled(context) && duo.isEnabled(context) && duo.isActivated(context) && duo.isReachable(context, moduleInfo.getNormalizedNumber()); } /** * Lookup URIs are currently fetched from the cached column of the system call log. This URI * contains encoded information for non-contacts for the purposes of populating contact cards. * *
We infer whether a contact is existing or not by checking if the lookup URI is "encoded" or * not. * *
TODO(zachh): We should revisit this once the contact URI is no longer being read from the * cached column in the system database, in case we decide not to overload the column. */ private boolean isExistingContact() { return !TextUtils.isEmpty(moduleInfo.getLookupUri()) && !UriUtils.isEncodedContactUri(Uri.parse(moduleInfo.getLookupUri())); } /** * Maps the value of {@link HistoryItemActionModuleInfo#getHost()} to {@link * CallInitiationType.Type}, which is required by {@link CallIntentBuilder} to build a call * intent. */ private CallInitiationType.Type getCallInitiationType() { switch (moduleInfo.getHost()) { case CALL_LOG: return CallInitiationType.Type.CALL_LOG; case VOICEMAIL: return CallInitiationType.Type.VOICEMAIL_LOG; default: throw Assert.createUnsupportedOperationFailException( String.format("Unsupported host: %s", moduleInfo.getHost())); } } /** * Maps the value of {@link HistoryItemActionModuleInfo#getHost()} to {@link * ReportingLocation.Type}, which is for logging where a spam number is reported. */ private ReportingLocation.Type getReportingLocation() { switch (moduleInfo.getHost()) { case CALL_LOG: return ReportingLocation.Type.CALL_LOG_HISTORY; case VOICEMAIL: return ReportingLocation.Type.VOICEMAIL_HISTORY; default: throw Assert.createUnsupportedOperationFailException( String.format("Unsupported host: %s", moduleInfo.getHost())); } } }