/* * Copyright (C) 2012 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.editor; import static android.provider.ContactsContract.CommonDataKinds.GroupMembership; import static android.provider.ContactsContract.CommonDataKinds.StructuredName; import static com.android.contacts.common.util.MaterialColorMapUtils.getDefaultPrimaryAndSecondaryColors; import android.content.Context; import android.content.res.Resources; import android.graphics.Bitmap; import android.graphics.BitmapFactory; import android.graphics.drawable.Drawable; import android.provider.ContactsContract.CommonDataKinds.Email; import android.provider.ContactsContract.CommonDataKinds.Event; import android.provider.ContactsContract.CommonDataKinds.Im; import android.provider.ContactsContract.CommonDataKinds.Note; import android.provider.ContactsContract.CommonDataKinds.Organization; import android.provider.ContactsContract.CommonDataKinds.Phone; import android.provider.ContactsContract.CommonDataKinds.Photo; import android.provider.ContactsContract.CommonDataKinds.Relation; import android.provider.ContactsContract.CommonDataKinds.SipAddress; import android.provider.ContactsContract.CommonDataKinds.StructuredPostal; import android.provider.ContactsContract.CommonDataKinds.Website; import android.media.RingtoneManager; import android.net.Uri; import android.os.Build; import android.text.TextUtils; import android.util.Pair; import android.widget.ImageView; import com.android.contacts.R; import com.android.contacts.common.ContactPhotoManager; import com.android.contacts.common.ContactPhotoManager.DefaultImageProvider; import com.android.contacts.common.ContactPhotoManager.DefaultImageRequest; import com.android.contacts.common.ContactsUtils; import com.android.contacts.common.model.ValuesDelta; import com.android.contacts.common.model.account.AccountType; import com.android.contacts.common.model.account.GoogleAccountType; import com.android.contacts.common.model.dataitem.DataKind; import com.android.contacts.common.testing.NeededForTesting; import com.android.contacts.common.util.MaterialColorMapUtils.MaterialPalette; import com.android.contacts.util.ContactPhotoUtils; import com.android.contacts.widget.QuickContactImageView; import com.google.common.collect.Maps; import java.io.FileNotFoundException; import java.util.HashMap; /** * Utility methods for creating contact editor. */ @NeededForTesting public class EditorUiUtils { // Maps DataKind.mimeType to editor view layouts. private static final HashMap mimetypeLayoutMap = Maps.newHashMap(); static { // Generally there should be a layout mapped to each existing DataKind mimetype but lots of // them use the default text_fields_editor_view which we return as default so they don't // need to be mapped. // // Other possible mime mappings are: // DataKind.PSEUDO_MIME_TYPE_DISPLAY_NAME // Nickname.CONTENT_ITEM_TYPE // Email.CONTENT_ITEM_TYPE // StructuredPostal.CONTENT_ITEM_TYPE // Im.CONTENT_ITEM_TYPE // Note.CONTENT_ITEM_TYPE // Organization.CONTENT_ITEM_TYPE // Phone.CONTENT_ITEM_TYPE // SipAddress.CONTENT_ITEM_TYPE // Website.CONTENT_ITEM_TYPE // Relation.CONTENT_ITEM_TYPE // // Un-supported mime types need to mapped with -1. mimetypeLayoutMap.put(DataKind.PSEUDO_MIME_TYPE_PHONETIC_NAME, R.layout.phonetic_name_editor_view); mimetypeLayoutMap.put(StructuredName.CONTENT_ITEM_TYPE, R.layout.structured_name_editor_view); mimetypeLayoutMap.put(GroupMembership.CONTENT_ITEM_TYPE, -1); mimetypeLayoutMap.put(Photo.CONTENT_ITEM_TYPE, -1); mimetypeLayoutMap.put(Event.CONTENT_ITEM_TYPE, R.layout.event_field_editor_view); } /** * Fetches a layout for a given mimetype. * * @param mimetype The mime type (e.g. StructuredName.CONTENT_ITEM_TYPE) * @return The layout resource id. */ public static int getLayoutResourceId(String mimetype) { final Integer id = mimetypeLayoutMap.get(mimetype); if (id == null) { return R.layout.text_fields_editor_view; } return id; } /** * Returns the account name and account type labels to display for local accounts. */ @NeededForTesting public static Pair getLocalAccountInfo(Context context, String accountName, AccountType accountType) { if (TextUtils.isEmpty(accountName)) { return new Pair<>( /* accountName =*/ null, context.getString(R.string.local_profile_title)); } return new Pair<>( accountName, context.getString(R.string.external_profile_title, accountType.getDisplayLabel(context))); } /** * Returns the account name and account type labels to display for the given account type. */ @NeededForTesting public static Pair getAccountInfo(Context context, String accountName, AccountType accountType) { CharSequence accountTypeDisplayLabel = accountType.getDisplayLabel(context); if (TextUtils.isEmpty(accountTypeDisplayLabel)) { accountTypeDisplayLabel = context.getString(R.string.account_phone); } if (TextUtils.isEmpty(accountName)) { return new Pair<>( /* accountName =*/ null, context.getString(R.string.account_type_format, accountTypeDisplayLabel)); } final String accountNameDisplayLabel = context.getString(R.string.from_account_format, accountName); if (GoogleAccountType.ACCOUNT_TYPE.equals(accountType.accountType) && accountType.dataSet == null) { return new Pair<>( accountNameDisplayLabel, context.getString(R.string.google_account_type_format, accountTypeDisplayLabel)); } return new Pair<>( accountNameDisplayLabel, context.getString(R.string.account_type_format, accountTypeDisplayLabel)); } /** * Returns a content description String for the container of the account information * returned by {@link #getAccountInfo}. */ public static String getAccountInfoContentDescription(CharSequence accountName, CharSequence accountType) { final StringBuilder builder = new StringBuilder(); if (!TextUtils.isEmpty(accountType)) { builder.append(accountType).append('\n'); } if (!TextUtils.isEmpty(accountName)) { builder.append(accountName); } return builder.toString(); } /** * Return an icon that represents {@param mimeType}. */ public static Drawable getMimeTypeDrawable(Context context, String mimeType) { switch (mimeType) { case StructuredName.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_person_black_24dp); case StructuredPostal.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_place_24dp); case SipAddress.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_dialer_sip_black_24dp); case Phone.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_phone_24dp); case Im.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_message_24dp); case Event.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_event_24dp); case Email.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_email_24dp); case Website.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_public_black_24dp); case Photo.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_camera_alt_black_24dp); case GroupMembership.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_people_black_24dp); case Organization.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_business_black_24dp); case Note.CONTENT_ITEM_TYPE: return context.getResources().getDrawable(R.drawable.ic_insert_comment_black_24dp); case Relation.CONTENT_ITEM_TYPE: return context.getResources().getDrawable( R.drawable.ic_circles_extended_black_24dp); default: return null; } } /** * Returns a ringtone string based on the ringtone URI and version #. */ @NeededForTesting public static String getRingtoneStringFromUri(Uri pickedUri, int currentVersion) { if (isNewerThanM(currentVersion)) { if (pickedUri == null) return ""; // silent ringtone if (RingtoneManager.isDefault(pickedUri)) return null; // default ringtone } if (pickedUri == null || RingtoneManager.isDefault(pickedUri)) return null; return pickedUri.toString(); } /** * Returns a ringtone URI, based on the string and version #. */ @NeededForTesting public static Uri getRingtoneUriFromString(String str, int currentVersion) { if (str != null) { if (isNewerThanM(currentVersion) && TextUtils.isEmpty(str)) return null; return Uri.parse(str); } return RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE); } private static boolean isNewerThanM(int currentVersion) { return currentVersion > Build.VERSION_CODES.M; } /** Returns the {@link Photo#PHOTO_FILE_ID} from the given ValuesDelta. */ public static Long getPhotoFileId(ValuesDelta valuesDelta) { if (valuesDelta == null) return null; if (valuesDelta.getAfter() == null || valuesDelta.getAfter().get(Photo.PHOTO) == null) { return valuesDelta.getAsLong(Photo.PHOTO_FILE_ID); } return null; } /** Binds the full resolution image at the given Uri to the provided ImageView. */ static void loadPhoto(ContactPhotoManager contactPhotoManager, ImageView imageView, Uri photoUri) { final DefaultImageProvider fallbackToPreviousImage = new DefaultImageProvider() { @Override public void applyDefaultImage(ImageView view, int extent, boolean darkTheme, DefaultImageRequest defaultImageRequest) { // Before we finish setting the full sized image, don't change the current // image that is set in any way. } }; contactPhotoManager.loadPhoto(imageView, photoUri, imageView.getWidth(), /* darkTheme =*/ false, /* isCircular =*/ false, /* defaultImageRequest =*/ null, fallbackToPreviousImage); } /** Decodes the Bitmap from the photo bytes from the given ValuesDelta. */ public static Bitmap getPhotoBitmap(ValuesDelta valuesDelta) { if (valuesDelta == null) return null; final byte[] bytes = valuesDelta.getAsByteArray(Photo.PHOTO); if (bytes == null) return null; return BitmapFactory.decodeByteArray(bytes, /* offset =*/ 0, bytes.length); } /** Binds the default avatar to the given ImageView and tints it to match QuickContacts. */ public static void setDefaultPhoto(ImageView imageView , Resources resources, MaterialPalette materialPalette) { // Use the default avatar drawable imageView.setImageDrawable(ContactPhotoManager.getDefaultAvatarDrawableForContact( resources, /* hires =*/ false, /* defaultImageRequest =*/ null)); // Tint it to match the quick contacts if (imageView instanceof QuickContactImageView) { ((QuickContactImageView) imageView).setTint(materialPalette == null ? getDefaultPrimaryAndSecondaryColors(resources).mPrimaryColor : materialPalette.mPrimaryColor); } } /** Returns compressed bitmap bytes from the given Uri, scaled to the thumbnail dimensions. */ public static byte[] getCompressedThumbnailBitmapBytes(Context context, Uri uri) throws FileNotFoundException { final Bitmap bitmap = ContactPhotoUtils.getBitmapFromUri(context, uri); final int size = ContactsUtils.getThumbnailSize(context); final Bitmap bitmapScaled = Bitmap.createScaledBitmap( bitmap, size, size, /* filter =*/ false); return ContactPhotoUtils.compressBitmap(bitmapScaled); } }