1 /* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.contacts.editor; 18 19 import static android.provider.ContactsContract.CommonDataKinds.GroupMembership; 20 import static android.provider.ContactsContract.CommonDataKinds.StructuredName; 21 22 import static com.android.contacts.util.MaterialColorMapUtils.getDefaultPrimaryAndSecondaryColors; 23 24 import android.content.Context; 25 import android.content.res.Resources; 26 import android.graphics.Bitmap; 27 import android.graphics.BitmapFactory; 28 import android.graphics.drawable.Drawable; 29 import android.media.RingtoneManager; 30 import android.net.Uri; 31 import android.os.Build; 32 import android.provider.ContactsContract.CommonDataKinds.Email; 33 import android.provider.ContactsContract.CommonDataKinds.Event; 34 import android.provider.ContactsContract.CommonDataKinds.Im; 35 import android.provider.ContactsContract.CommonDataKinds.Note; 36 import android.provider.ContactsContract.CommonDataKinds.Organization; 37 import android.provider.ContactsContract.CommonDataKinds.Phone; 38 import android.provider.ContactsContract.CommonDataKinds.Photo; 39 import android.provider.ContactsContract.CommonDataKinds.Relation; 40 import android.provider.ContactsContract.CommonDataKinds.SipAddress; 41 import android.provider.ContactsContract.CommonDataKinds.StructuredPostal; 42 import android.provider.ContactsContract.CommonDataKinds.Website; 43 import androidx.core.content.res.ResourcesCompat; 44 import android.text.TextUtils; 45 import android.widget.ImageView; 46 47 import com.android.contacts.ContactPhotoManager; 48 import com.android.contacts.ContactPhotoManager.DefaultImageProvider; 49 import com.android.contacts.ContactPhotoManager.DefaultImageRequest; 50 import com.android.contacts.ContactsUtils; 51 import com.android.contacts.R; 52 import com.android.contacts.model.ValuesDelta; 53 import com.android.contacts.model.account.AccountDisplayInfo; 54 import com.android.contacts.model.account.AccountInfo; 55 import com.android.contacts.model.dataitem.DataKind; 56 import com.android.contacts.util.ContactPhotoUtils; 57 import com.android.contacts.util.MaterialColorMapUtils.MaterialPalette; 58 import com.android.contacts.widget.QuickContactImageView; 59 60 import com.google.common.collect.Maps; 61 62 import java.io.FileNotFoundException; 63 import java.util.HashMap; 64 65 /** 66 * Utility methods for creating contact editor. 67 */ 68 public class EditorUiUtils { 69 70 // Maps DataKind.mimeType to editor view layouts. 71 private static final HashMap<String, Integer> mimetypeLayoutMap = Maps.newHashMap(); 72 static { 73 // Generally there should be a layout mapped to each existing DataKind mimetype but lots of 74 // them use the default text_fields_editor_view which we return as default so they don't 75 // need to be mapped. 76 // 77 // Other possible mime mappings are: 78 // DataKind.PSEUDO_MIME_TYPE_DISPLAY_NAME 79 // Nickname.CONTENT_ITEM_TYPE 80 // Email.CONTENT_ITEM_TYPE 81 // StructuredPostal.CONTENT_ITEM_TYPE 82 // Im.CONTENT_ITEM_TYPE 83 // Note.CONTENT_ITEM_TYPE 84 // Organization.CONTENT_ITEM_TYPE 85 // Phone.CONTENT_ITEM_TYPE 86 // SipAddress.CONTENT_ITEM_TYPE 87 // Website.CONTENT_ITEM_TYPE 88 // Relation.CONTENT_ITEM_TYPE 89 // 90 // Un-supported mime types need to mapped with -1. mimetypeLayoutMap.put(StructuredName.CONTENT_ITEM_TYPE, R.layout.structured_name_editor_view)91 mimetypeLayoutMap.put(StructuredName.CONTENT_ITEM_TYPE, 92 R.layout.structured_name_editor_view); mimetypeLayoutMap.put(GroupMembership.CONTENT_ITEM_TYPE, -1)93 mimetypeLayoutMap.put(GroupMembership.CONTENT_ITEM_TYPE, -1); mimetypeLayoutMap.put(Photo.CONTENT_ITEM_TYPE, -1)94 mimetypeLayoutMap.put(Photo.CONTENT_ITEM_TYPE, -1); mimetypeLayoutMap.put(Event.CONTENT_ITEM_TYPE, R.layout.event_field_editor_view)95 mimetypeLayoutMap.put(Event.CONTENT_ITEM_TYPE, R.layout.event_field_editor_view); 96 } 97 98 /** 99 * Fetches a layout for a given mimetype. 100 * 101 * @param mimetype The mime type (e.g. StructuredName.CONTENT_ITEM_TYPE) 102 * @return The layout resource id. 103 */ getLayoutResourceId(String mimetype)104 public static int getLayoutResourceId(String mimetype) { 105 final Integer id = mimetypeLayoutMap.get(mimetype); 106 if (id == null) { 107 return R.layout.text_fields_editor_view; 108 } 109 return id; 110 } 111 112 getAccountHeaderLabelForMyProfile(Context context, AccountInfo accountInfo)113 public static String getAccountHeaderLabelForMyProfile(Context context, 114 AccountInfo accountInfo) { 115 if (accountInfo.isDeviceAccount()) { 116 return context.getString(R.string.local_profile_title); 117 } else { 118 return context.getString(R.string.external_profile_title, 119 accountInfo.getTypeLabel()); 120 } 121 } 122 getAccountTypeHeaderLabel(Context context, AccountDisplayInfo displayableAccount)123 public static String getAccountTypeHeaderLabel(Context context, AccountDisplayInfo 124 displayableAccount) { 125 if (displayableAccount.isDeviceAccount()) { 126 // Do nothing. Type label should be "Device" 127 return displayableAccount.getTypeLabel().toString(); 128 } else if (displayableAccount.isGoogleAccount()) { 129 return context.getString(R.string.google_account_type_format, 130 displayableAccount.getTypeLabel()); 131 } else { 132 return context.getString(R.string.account_type_format, 133 displayableAccount.getTypeLabel()); 134 } 135 } 136 137 /** 138 * Returns a content description String for the container of the account information 139 * returned by {@link #getAccountTypeHeaderLabel(Context, AccountDisplayInfo)}. 140 */ getAccountInfoContentDescription(CharSequence accountName, CharSequence accountType)141 public static String getAccountInfoContentDescription(CharSequence accountName, 142 CharSequence accountType) { 143 final StringBuilder builder = new StringBuilder(); 144 if (!TextUtils.isEmpty(accountType)) { 145 builder.append(accountType).append('\n'); 146 } 147 if (!TextUtils.isEmpty(accountName)) { 148 builder.append(accountName); 149 } 150 return builder.toString(); 151 } 152 153 /** 154 * Return an icon that represents {@param mimeType}. 155 */ getMimeTypeDrawable(Context context, String mimeType)156 public static Drawable getMimeTypeDrawable(Context context, String mimeType) { 157 switch (mimeType) { 158 case StructuredName.CONTENT_ITEM_TYPE: 159 return ResourcesCompat.getDrawable(context.getResources(), 160 R.drawable.quantum_ic_person_vd_theme_24, null); 161 case StructuredPostal.CONTENT_ITEM_TYPE: 162 return ResourcesCompat.getDrawable(context.getResources(), 163 R.drawable.quantum_ic_place_vd_theme_24, null); 164 case SipAddress.CONTENT_ITEM_TYPE: 165 return ResourcesCompat.getDrawable(context.getResources(), 166 R.drawable.quantum_ic_dialer_sip_vd_theme_24, null); 167 case Phone.CONTENT_ITEM_TYPE: 168 return ResourcesCompat.getDrawable(context.getResources(), 169 R.drawable.quantum_ic_phone_vd_theme_24, null); 170 case Im.CONTENT_ITEM_TYPE: 171 return ResourcesCompat.getDrawable(context.getResources(), 172 R.drawable.quantum_ic_message_vd_theme_24, null); 173 case Event.CONTENT_ITEM_TYPE: 174 return ResourcesCompat.getDrawable(context.getResources(), 175 R.drawable.quantum_ic_event_vd_theme_24, null); 176 case Email.CONTENT_ITEM_TYPE: 177 return ResourcesCompat.getDrawable(context.getResources(), 178 R.drawable.quantum_ic_email_vd_theme_24, null); 179 case Website.CONTENT_ITEM_TYPE: 180 return ResourcesCompat.getDrawable(context.getResources(), 181 R.drawable.quantum_ic_public_vd_theme_24, null); 182 case Photo.CONTENT_ITEM_TYPE: 183 return ResourcesCompat.getDrawable(context.getResources(), 184 R.drawable.quantum_ic_camera_alt_vd_theme_24, null); 185 case GroupMembership.CONTENT_ITEM_TYPE: 186 return ResourcesCompat.getDrawable(context.getResources(), 187 R.drawable.quantum_ic_label_vd_theme_24, null); 188 case Organization.CONTENT_ITEM_TYPE: 189 return ResourcesCompat.getDrawable(context.getResources(), 190 R.drawable.quantum_ic_business_vd_theme_24, null); 191 case Note.CONTENT_ITEM_TYPE: 192 return ResourcesCompat.getDrawable(context.getResources(), 193 R.drawable.quantum_ic_insert_comment_vd_theme_24, null); 194 case Relation.CONTENT_ITEM_TYPE: 195 return ResourcesCompat.getDrawable(context.getResources(), 196 R.drawable.quantum_ic_circles_ext_vd_theme_24, null); 197 default: 198 return null; 199 } 200 } 201 202 /** 203 * Returns a ringtone string based on the ringtone URI and version #. 204 */ getRingtoneStringFromUri(Uri pickedUri, int currentVersion)205 public static String getRingtoneStringFromUri(Uri pickedUri, int currentVersion) { 206 if (isNewerThanM(currentVersion)) { 207 if (pickedUri == null) return ""; // silent ringtone 208 if (RingtoneManager.isDefault(pickedUri)) return null; // default ringtone 209 } 210 if (pickedUri == null || RingtoneManager.isDefault(pickedUri)) return null; 211 return pickedUri.toString(); 212 } 213 214 /** 215 * Returns a ringtone URI, based on the string and version #. 216 */ getRingtoneUriFromString(String str, int currentVersion)217 public static Uri getRingtoneUriFromString(String str, int currentVersion) { 218 if (str != null) { 219 if (isNewerThanM(currentVersion) && TextUtils.isEmpty(str)) return null; 220 return Uri.parse(str); 221 } 222 return RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE); 223 } 224 isNewerThanM(int currentVersion)225 private static boolean isNewerThanM(int currentVersion) { 226 return currentVersion > Build.VERSION_CODES.M; 227 } 228 229 /** Returns the {@link Photo#PHOTO_FILE_ID} from the given ValuesDelta. */ getPhotoFileId(ValuesDelta valuesDelta)230 public static Long getPhotoFileId(ValuesDelta valuesDelta) { 231 if (valuesDelta == null) return null; 232 if (valuesDelta.getAfter() == null || valuesDelta.getAfter().get(Photo.PHOTO) == null) { 233 return valuesDelta.getAsLong(Photo.PHOTO_FILE_ID); 234 } 235 return null; 236 } 237 238 /** Binds the full resolution image at the given Uri to the provided ImageView. */ loadPhoto(ContactPhotoManager contactPhotoManager, ImageView imageView, Uri photoUri)239 static void loadPhoto(ContactPhotoManager contactPhotoManager, ImageView imageView, 240 Uri photoUri) { 241 final DefaultImageProvider fallbackToPreviousImage = new DefaultImageProvider() { 242 @Override 243 public void applyDefaultImage(ImageView view, int extent, boolean darkTheme, 244 DefaultImageRequest defaultImageRequest) { 245 // Before we finish setting the full sized image, don't change the current 246 // image that is set in any way. 247 } 248 }; 249 contactPhotoManager.loadPhoto(imageView, photoUri, imageView.getWidth(), 250 /* darkTheme =*/ false, /* isCircular =*/ false, 251 /* defaultImageRequest =*/ null, fallbackToPreviousImage); 252 } 253 254 /** Decodes the Bitmap from the photo bytes from the given ValuesDelta. */ getPhotoBitmap(ValuesDelta valuesDelta)255 public static Bitmap getPhotoBitmap(ValuesDelta valuesDelta) { 256 if (valuesDelta == null) return null; 257 final byte[] bytes = valuesDelta.getAsByteArray(Photo.PHOTO); 258 if (bytes == null) return null; 259 return BitmapFactory.decodeByteArray(bytes, /* offset =*/ 0, bytes.length); 260 } 261 262 /** Binds the default avatar to the given ImageView and tints it to match QuickContacts. */ setDefaultPhoto(ImageView imageView , Resources resources, MaterialPalette materialPalette)263 public static void setDefaultPhoto(ImageView imageView , Resources resources, 264 MaterialPalette materialPalette) { 265 // Use the default avatar drawable 266 imageView.setImageDrawable(ContactPhotoManager.getDefaultAvatarDrawableForContact( 267 resources, /* hires =*/ false, /* defaultImageRequest =*/ null)); 268 269 // Tint it to match the quick contacts 270 if (imageView instanceof QuickContactImageView) { 271 ((QuickContactImageView) imageView).setTint(materialPalette == null 272 ? getDefaultPrimaryAndSecondaryColors(resources).mPrimaryColor 273 : materialPalette.mPrimaryColor); 274 } 275 } 276 277 /** Returns compressed bitmap bytes from the given Uri, scaled to the thumbnail dimensions. */ getCompressedThumbnailBitmapBytes(Context context, Uri uri)278 public static byte[] getCompressedThumbnailBitmapBytes(Context context, Uri uri) 279 throws FileNotFoundException { 280 final Bitmap bitmap = ContactPhotoUtils.getBitmapFromUri(context, uri); 281 final int size = ContactsUtils.getThumbnailSize(context); 282 final Bitmap bitmapScaled = Bitmap.createScaledBitmap( 283 bitmap, size, size, /* filter =*/ false); 284 return ContactPhotoUtils.compressBitmap(bitmapScaled); 285 } 286 287 } 288