| /* |
| * Copyright (C) 2009 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.contacts; |
| |
| import android.content.ComponentName; |
| import android.content.Context; |
| import android.content.Intent; |
| import android.content.res.Configuration; |
| import android.database.Cursor; |
| import android.graphics.Rect; |
| import android.location.CountryDetector; |
| import android.net.Uri; |
| import android.provider.ContactsContract; |
| import android.provider.ContactsContract.CommonDataKinds.Im; |
| import android.provider.ContactsContract.CommonDataKinds.Phone; |
| import android.provider.ContactsContract.DisplayPhoto; |
| import android.provider.ContactsContract.QuickContact; |
| import android.telephony.PhoneNumberUtils; |
| import android.text.TextUtils; |
| import android.view.View; |
| import android.widget.TextView; |
| |
| import com.android.contacts.activities.DialtactsActivity; |
| import com.android.contacts.model.AccountTypeManager; |
| import com.android.contacts.model.account.AccountType; |
| import com.android.contacts.model.account.AccountWithDataSet; |
| import com.android.contacts.test.NeededForTesting; |
| import com.android.contacts.util.Constants; |
| |
| import java.util.List; |
| |
| public class ContactsUtils { |
| private static final String TAG = "ContactsUtils"; |
| private static final String WAIT_SYMBOL_AS_STRING = String.valueOf(PhoneNumberUtils.WAIT); |
| |
| private static final ComponentName CALL_INTENT_DESTINATION = new ComponentName( |
| "com.android.phone", "com.android.phone.PrivilegedOutgoingCallBroadcaster"); |
| |
| private static int sThumbnailSize = -1; |
| |
| // TODO find a proper place for the canonical version of these |
| public interface ProviderNames { |
| String YAHOO = "Yahoo"; |
| String GTALK = "GTalk"; |
| String MSN = "MSN"; |
| String ICQ = "ICQ"; |
| String AIM = "AIM"; |
| String XMPP = "XMPP"; |
| String JABBER = "JABBER"; |
| String SKYPE = "SKYPE"; |
| String QQ = "QQ"; |
| } |
| |
| /** |
| * This looks up the provider name defined in |
| * ProviderNames from the predefined IM protocol id. |
| * This is used for interacting with the IM application. |
| * |
| * @param protocol the protocol ID |
| * @return the provider name the IM app uses for the given protocol, or null if no |
| * provider is defined for the given protocol |
| * @hide |
| */ |
| public static String lookupProviderNameFromId(int protocol) { |
| switch (protocol) { |
| case Im.PROTOCOL_GOOGLE_TALK: |
| return ProviderNames.GTALK; |
| case Im.PROTOCOL_AIM: |
| return ProviderNames.AIM; |
| case Im.PROTOCOL_MSN: |
| return ProviderNames.MSN; |
| case Im.PROTOCOL_YAHOO: |
| return ProviderNames.YAHOO; |
| case Im.PROTOCOL_ICQ: |
| return ProviderNames.ICQ; |
| case Im.PROTOCOL_JABBER: |
| return ProviderNames.JABBER; |
| case Im.PROTOCOL_SKYPE: |
| return ProviderNames.SKYPE; |
| case Im.PROTOCOL_QQ: |
| return ProviderNames.QQ; |
| } |
| return null; |
| } |
| |
| /** |
| * Test if the given {@link CharSequence} contains any graphic characters, |
| * first checking {@link TextUtils#isEmpty(CharSequence)} to handle null. |
| */ |
| public static boolean isGraphic(CharSequence str) { |
| return !TextUtils.isEmpty(str) && TextUtils.isGraphic(str); |
| } |
| |
| /** |
| * Returns true if two objects are considered equal. Two null references are equal here. |
| */ |
| @NeededForTesting |
| public static boolean areObjectsEqual(Object a, Object b) { |
| return a == b || (a != null && a.equals(b)); |
| } |
| |
| /** |
| * Returns true if two data with mimetypes which represent values in contact entries are |
| * considered equal for collapsing in the GUI. For caller-id, use |
| * {@link PhoneNumberUtils#compare(Context, String, String)} instead |
| */ |
| public static final boolean shouldCollapse(CharSequence mimetype1, CharSequence data1, |
| CharSequence mimetype2, CharSequence data2) { |
| // different mimetypes? don't collapse |
| if (!TextUtils.equals(mimetype1, mimetype2)) return false; |
| |
| // exact same string? good, bail out early |
| if (TextUtils.equals(data1, data2)) return true; |
| |
| // so if either is null, these two must be different |
| if (data1 == null || data2 == null) return false; |
| |
| // if this is not about phone numbers, we know this is not a match (of course, some |
| // mimetypes could have more sophisticated matching is the future, e.g. addresses) |
| if (!TextUtils.equals(Phone.CONTENT_ITEM_TYPE, mimetype1)) return false; |
| |
| return shouldCollapsePhoneNumbers(data1.toString(), data2.toString()); |
| } |
| |
| private static final boolean shouldCollapsePhoneNumbers( |
| String number1WithLetters, String number2WithLetters) { |
| final String number1 = PhoneNumberUtils.convertKeypadLettersToDigits(number1WithLetters); |
| final String number2 = PhoneNumberUtils.convertKeypadLettersToDigits(number2WithLetters); |
| |
| int index1 = 0; |
| int index2 = 0; |
| for (;;) { |
| // Skip formatting characters. |
| while (index1 < number1.length() && |
| !PhoneNumberUtils.isNonSeparator(number1.charAt(index1))) { |
| index1++; |
| } |
| while (index2 < number2.length() && |
| !PhoneNumberUtils.isNonSeparator(number2.charAt(index2))) { |
| index2++; |
| } |
| // If both have finished, match. If only one has finished, not match. |
| final boolean number1End = (index1 == number1.length()); |
| final boolean number2End = (index2 == number2.length()); |
| if (number1End) { |
| return number2End; |
| } |
| if (number2End) return false; |
| |
| // If the non-formatting characters are different, not match. |
| if (number1.charAt(index1) != number2.charAt(index2)) return false; |
| |
| // Go to the next characters. |
| index1++; |
| index2++; |
| } |
| } |
| |
| /** |
| * Returns true if two {@link Intent}s are both null, or have the same action. |
| */ |
| public static final boolean areIntentActionEqual(Intent a, Intent b) { |
| if (a == b) { |
| return true; |
| } |
| if (a == null || b == null) { |
| return false; |
| } |
| return TextUtils.equals(a.getAction(), b.getAction()); |
| } |
| |
| /** |
| * @return The ISO 3166-1 two letters country code of the country the user |
| * is in. |
| */ |
| public static final String getCurrentCountryIso(Context context) { |
| CountryDetector detector = |
| (CountryDetector) context.getSystemService(Context.COUNTRY_DETECTOR); |
| return detector.detectCountry().getCountryIso(); |
| } |
| |
| public static boolean areContactWritableAccountsAvailable(Context context) { |
| final List<AccountWithDataSet> accounts = |
| AccountTypeManager.getInstance(context).getAccounts(true /* writeable */); |
| return !accounts.isEmpty(); |
| } |
| |
| public static boolean areGroupWritableAccountsAvailable(Context context) { |
| final List<AccountWithDataSet> accounts = |
| AccountTypeManager.getInstance(context).getGroupWritableAccounts(); |
| return !accounts.isEmpty(); |
| } |
| |
| /** |
| * Returns the intent to launch for the given invitable account type and contact lookup URI. |
| * This will return null if the account type is not invitable (i.e. there is no |
| * {@link AccountType#getInviteContactActivityClassName()} or |
| * {@link AccountType#syncAdapterPackageName}). |
| */ |
| public static Intent getInvitableIntent(AccountType accountType, Uri lookupUri) { |
| String syncAdapterPackageName = accountType.syncAdapterPackageName; |
| String className = accountType.getInviteContactActivityClassName(); |
| if (TextUtils.isEmpty(syncAdapterPackageName) || TextUtils.isEmpty(className)) { |
| return null; |
| } |
| Intent intent = new Intent(); |
| intent.setClassName(syncAdapterPackageName, className); |
| |
| intent.setAction(ContactsContract.Intents.INVITE_CONTACT); |
| |
| // Data is the lookup URI. |
| intent.setData(lookupUri); |
| return intent; |
| } |
| |
| /** |
| * Return Uri with an appropriate scheme, accepting Voicemail, SIP, and usual phone call |
| * numbers. |
| */ |
| public static Uri getCallUri(String number) { |
| if (PhoneNumberUtils.isUriNumber(number)) { |
| return Uri.fromParts(Constants.SCHEME_SIP, number, null); |
| } |
| return Uri.fromParts(Constants.SCHEME_TEL, number, null); |
| } |
| |
| /** |
| * Return an Intent for making a phone call. Scheme (e.g. tel, sip) will be determined |
| * automatically. |
| */ |
| public static Intent getCallIntent(String number) { |
| return getCallIntent(number, null); |
| } |
| |
| /** |
| * Return an Intent for making a phone call. A given Uri will be used as is (without any |
| * sanity check). |
| */ |
| public static Intent getCallIntent(Uri uri) { |
| return getCallIntent(uri, null); |
| } |
| |
| /** |
| * A variant of {@link #getCallIntent(String)} but also accept a call origin. For more |
| * information about call origin, see comments in Phone package (PhoneApp). |
| */ |
| public static Intent getCallIntent(String number, String callOrigin) { |
| return getCallIntent(getCallUri(number), callOrigin); |
| } |
| |
| /** |
| * A variant of {@link #getCallIntent(Uri)} but also accept a call origin. For more |
| * information about call origin, see comments in Phone package (PhoneApp). |
| */ |
| public static Intent getCallIntent(Uri uri, String callOrigin) { |
| final Intent intent = new Intent(Intent.ACTION_CALL_PRIVILEGED, uri); |
| intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); |
| if (callOrigin != null) { |
| intent.putExtra(DialtactsActivity.EXTRA_CALL_ORIGIN, callOrigin); |
| } |
| |
| // Set phone as an explicit component of CALL_PRIVILEGED intent. |
| // Setting destination explicitly prevents other apps from capturing this Intent since, |
| // unlike SendBroadcast, there is no API for specifying a permission on startActivity. |
| intent.setComponent(CALL_INTENT_DESTINATION); |
| |
| return intent; |
| } |
| |
| /** |
| * Return an Intent for launching voicemail screen. |
| */ |
| public static Intent getVoicemailIntent() { |
| final Intent intent = new Intent(Intent.ACTION_CALL_PRIVILEGED, |
| Uri.fromParts("voicemail", "", null)); |
| intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK); |
| return intent; |
| } |
| |
| /** |
| * Returns a header view based on the R.layout.list_separator, where the |
| * containing {@link TextView} is set using the given textResourceId. |
| */ |
| public static View createHeaderView(Context context, int textResourceId) { |
| View view = View.inflate(context, R.layout.list_separator, null); |
| TextView textView = (TextView) view.findViewById(R.id.title); |
| textView.setText(context.getString(textResourceId)); |
| return view; |
| } |
| |
| /** |
| * Returns the {@link Rect} with left, top, right, and bottom coordinates |
| * that are equivalent to the given {@link View}'s bounds. This is equivalent to how the |
| * target {@link Rect} is calculated in {@link QuickContact#showQuickContact}. |
| */ |
| public static Rect getTargetRectFromView(Context context, View view) { |
| final float appScale = context.getResources().getCompatibilityInfo().applicationScale; |
| final int[] pos = new int[2]; |
| view.getLocationOnScreen(pos); |
| |
| final Rect rect = new Rect(); |
| rect.left = (int) (pos[0] * appScale + 0.5f); |
| rect.top = (int) (pos[1] * appScale + 0.5f); |
| rect.right = (int) ((pos[0] + view.getWidth()) * appScale + 0.5f); |
| rect.bottom = (int) ((pos[1] + view.getHeight()) * appScale + 0.5f); |
| return rect; |
| } |
| |
| /** |
| * Returns the size (width and height) of thumbnail pictures as configured in the provider. This |
| * can safely be called from the UI thread, as the provider can serve this without performing |
| * a database access |
| */ |
| public static int getThumbnailSize(Context context) { |
| if (sThumbnailSize == -1) { |
| final Cursor c = context.getContentResolver().query( |
| DisplayPhoto.CONTENT_MAX_DIMENSIONS_URI, |
| new String[] { DisplayPhoto.THUMBNAIL_MAX_DIM }, null, null, null); |
| try { |
| c.moveToFirst(); |
| sThumbnailSize = c.getInt(0); |
| } finally { |
| c.close(); |
| } |
| } |
| return sThumbnailSize; |
| } |
| |
| /** |
| * @return if the context is in landscape orientation. |
| */ |
| public static boolean isLandscape(Context context) { |
| return context.getResources().getConfiguration().orientation |
| == Configuration.ORIENTATION_LANDSCAPE; |
| } |
| } |
