telecomm/java/android/telecom/PhoneAccount.java - platform/frameworks/base - Git at Google

 /*
  * Copyright (C) 2014 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 android.telecom;

 import android.content.ComponentName;
 import android.content.Context;
 import android.content.pm.PackageManager;
 import android.content.res.Resources.NotFoundException;
 import android.graphics.Bitmap;
 import android.graphics.Color;
 import android.graphics.drawable.BitmapDrawable;
 import android.graphics.drawable.ColorDrawable;
 import android.graphics.drawable.Drawable;
 import android.net.Uri;
 import android.os.Parcel;
 import android.os.Parcelable;
 import android.text.TextUtils;

 import java.lang.String;
 import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 import java.util.MissingResourceException;

 /**
  * Represents a distinct method to place or receive a phone call. Apps which can place calls and
  * want those calls to be integrated into the dialer and in-call UI should build an instance of
  * this class and register it with the system using {@link TelecomManager#registerPhoneAccount}.
  * <p>
  * {@link TelecomManager} uses registered {@link PhoneAccount}s to present the user with
  * alternative options when placing a phone call. When building a {@link PhoneAccount}, the app
  * should supply a valid {@link PhoneAccountHandle} that references the {@link ConnectionService}
  * implementation Telecom will use to interact with the app.
  */
 public class PhoneAccount implements Parcelable {

     /**
      * Flag indicating that this {@code PhoneAccount} can act as a connection manager for
      * other connections. The {@link ConnectionService} associated with this {@code PhoneAccount}
      * will be allowed to manage phone calls including using its own proprietary phone-call
      * implementation (like VoIP calling) to make calls instead of the telephony stack.
      * <p>
      * When a user opts to place a call using the SIM-based telephony stack, the
      * {@link ConnectionService} associated with this {@code PhoneAccount} will be attempted first
      * if the user has explicitly selected it to be used as the default connection manager.
      * <p>
      * See {@link #getCapabilities}
      */
     public static final int CAPABILITY_CONNECTION_MANAGER = 0x1;

     /**
      * Flag indicating that this {@code PhoneAccount} can make phone calls in place of
      * traditional SIM-based telephony calls. This account will be treated as a distinct method
      * for placing calls alongside the traditional SIM-based telephony stack. This flag is
      * distinct from {@link #CAPABILITY_CONNECTION_MANAGER} in that it is not allowed to manage
      * or place calls from the built-in telephony stack.
      * <p>
      * See {@link #getCapabilities}
      * <p>
      * {@hide}
      */
     public static final int CAPABILITY_CALL_PROVIDER = 0x2;

     /**
      * Flag indicating that this {@code PhoneAccount} represents a built-in PSTN SIM
      * subscription.
      * <p>
      * Only the Android framework can register a {@code PhoneAccount} having this capability.
      * <p>
      * See {@link #getCapabilities}
      */
     public static final int CAPABILITY_SIM_SUBSCRIPTION = 0x4;

     /**
      * Flag indicating that this {@code PhoneAccount} is capable of placing video calls.
      * <p>
      * See {@link #getCapabilities}
      * @hide
      */
     public static final int CAPABILITY_VIDEO_CALLING = 0x8;

     /**
      * Flag indicating that this {@code PhoneAccount} is capable of placing emergency calls.
      * By default all PSTN {@code PhoneAccount}s are capable of placing emergency calls.
      * <p>
      * See {@link #getCapabilities}
      */
     public static final int CAPABILITY_PLACE_EMERGENCY_CALLS = 0x10;

     /**
      * URI scheme for telephone number URIs.
      */
     public static final String SCHEME_TEL = "tel";

     /**
      * URI scheme for voicemail URIs.
      */
     public static final String SCHEME_VOICEMAIL = "voicemail";

     /**
      * URI scheme for SIP URIs.
      */
     public static final String SCHEME_SIP = "sip";

     /**
      * Indicating no color is set.
      */
     public static final int NO_COLOR = -1;

     private final PhoneAccountHandle mAccountHandle;
     private final Uri mAddress;
     private final Uri mSubscriptionAddress;
     private final int mCapabilities;
     private final int mIconResId;
     private final String mIconPackageName;
     private final Bitmap mIconBitmap;
     private final int mColor;
     private final CharSequence mLabel;
     private final CharSequence mShortDescription;
     private final List<String> mSupportedUriSchemes;

     /**
      * Helper class for creating a {@link PhoneAccount}.
      */
     public static class Builder {
         private PhoneAccountHandle mAccountHandle;
         private Uri mAddress;
         private Uri mSubscriptionAddress;
         private int mCapabilities;
         private int mIconResId;
         private String mIconPackageName;
         private Bitmap mIconBitmap;
         private int mColor = NO_COLOR;
         private CharSequence mLabel;
         private CharSequence mShortDescription;
         private List<String> mSupportedUriSchemes = new ArrayList<String>();

         /**
          * Creates a builder with the specified {@link PhoneAccountHandle} and label.
          */
         public Builder(PhoneAccountHandle accountHandle, CharSequence label) {
             this.mAccountHandle = accountHandle;
             this.mLabel = label;
         }

         /**
          * Creates an instance of the {@link PhoneAccount.Builder} from an existing
          * {@link PhoneAccount}.
          *
          * @param phoneAccount The {@link PhoneAccount} used to initialize the builder.
          */
         public Builder(PhoneAccount phoneAccount) {
             mAccountHandle = phoneAccount.getAccountHandle();
             mAddress = phoneAccount.getAddress();
             mSubscriptionAddress = phoneAccount.getSubscriptionAddress();
             mCapabilities = phoneAccount.getCapabilities();
             mIconResId = phoneAccount.getIconResId();
             mIconPackageName = phoneAccount.getIconPackageName();
             mIconBitmap = phoneAccount.getIconBitmap();
             mColor = phoneAccount.getColor();
             mLabel = phoneAccount.getLabel();
             mShortDescription = phoneAccount.getShortDescription();
             mSupportedUriSchemes.addAll(phoneAccount.getSupportedUriSchemes());
         }

         /**
          * Sets the address. See {@link PhoneAccount#getAddress}.
          *
          * @param value The address of the phone account.
          * @return The builder.
          */
         public Builder setAddress(Uri value) {
             this.mAddress = value;
             return this;
         }

         /**
          * Sets the subscription address. See {@link PhoneAccount#getSubscriptionAddress}.
          *
          * @param value The subscription address.
          * @return The builder.
          */
         public Builder setSubscriptionAddress(Uri value) {
             this.mSubscriptionAddress = value;
             return this;
         }

         /**
          * Sets the capabilities. See {@link PhoneAccount#getCapabilities}.
          *
          * @param value The capabilities to set.
          * @return The builder.
          */
         public Builder setCapabilities(int value) {
             this.mCapabilities = value;
             return this;
         }

         /**
          * Sets the icon resource ID. See {@link PhoneAccount#getIconResId}.
          *
          * @param value The resource ID of the icon.
          * @return The builder.
          */
         public Builder setIconResId(int value) {
             this.mIconResId = value;
             return this;
         }

         /**
          * Sets the icon package name. See {@link PhoneAccount#getIconPackageName}.
          *
          * @param value The name of the package from which to load the icon.
          * @return The builder.
          */
         public Builder setIconPackageName(String value) {
             this.mIconPackageName = value;
             return this;
         }

         /**
          * Sets the icon bitmap. See {@link PhoneAccount#getIconBitmap}.
          *
          * @param value The icon bitmap.
          * @return The builder.
          */
         public Builder setIconBitmap(Bitmap value) {
             this.mIconBitmap = value;
             return this;
         }

         /**
          * Sets the color. See {@link PhoneAccount#getColor}.
          *
          * @param value The resource ID of the icon.
          * @return The builder.
          */
         public Builder setColor(int value) {
             this.mColor = value;
             return this;
         }

         /**
          * Sets the short description. See {@link PhoneAccount#getShortDescription}.
          *
          * @param value The short description.
          * @return The builder.
          */
         public Builder setShortDescription(CharSequence value) {
             this.mShortDescription = value;
             return this;
         }

         /**
          * Specifies an additional URI scheme supported by the {@link PhoneAccount}.
          *
          * @param uriScheme The URI scheme.
          * @return The builder.
          * @hide
          */
         public Builder addSupportedUriScheme(String uriScheme) {
             if (!TextUtils.isEmpty(uriScheme) && !mSupportedUriSchemes.contains(uriScheme)) {
                 this.mSupportedUriSchemes.add(uriScheme);
             }
             return this;
         }

         /**
          * Specifies the URI schemes supported by the {@link PhoneAccount}.
          *
          * @param uriSchemes The URI schemes.
          * @return The builder.
          */
         public Builder setSupportedUriSchemes(List<String> uriSchemes) {
             mSupportedUriSchemes.clear();

             if (uriSchemes != null && !uriSchemes.isEmpty()) {
                 for (String uriScheme : uriSchemes) {
                     addSupportedUriScheme(uriScheme);
                 }
             }
             return this;
         }

         /**
          * Creates an instance of a {@link PhoneAccount} based on the current builder settings.
          *
          * @return The {@link PhoneAccount}.
          */
         public PhoneAccount build() {
             // If no supported URI schemes were defined, assume "tel" is supported.
             if (mSupportedUriSchemes.isEmpty()) {
                 addSupportedUriScheme(SCHEME_TEL);
             }

             return new PhoneAccount(
                     mAccountHandle,
                     mAddress,
                     mSubscriptionAddress,
                     mCapabilities,
                     mIconResId,
                     mIconPackageName,
                     mIconBitmap,
                     mColor,
                     mLabel,
                     mShortDescription,
                     mSupportedUriSchemes);
         }
     }

     private PhoneAccount(
             PhoneAccountHandle account,
             Uri address,
             Uri subscriptionAddress,
             int capabilities,
             int iconResId,
             String iconPackageName,
             Bitmap iconBitmap,
             int color,
             CharSequence label,
             CharSequence shortDescription,
             List<String> supportedUriSchemes) {
         mAccountHandle = account;
         mAddress = address;
         mSubscriptionAddress = subscriptionAddress;
         mCapabilities = capabilities;
         mIconResId = iconResId;
         mIconPackageName = iconPackageName;
         mIconBitmap = iconBitmap;
         mColor = color;
         mLabel = label;
         mShortDescription = shortDescription;
         mSupportedUriSchemes = Collections.unmodifiableList(supportedUriSchemes);
     }

     public static Builder builder(
             PhoneAccountHandle accountHandle,
             CharSequence label) {
         return new Builder(accountHandle, label);
     }

     /**
      * Returns a builder initialized with the current {@link PhoneAccount} instance.
      *
      * @return The builder.
      * @hide
      */
     public Builder toBuilder() { return new Builder(this); }

     /**
      * The unique identifier of this {@code PhoneAccount}.
      *
      * @return A {@code PhoneAccountHandle}.
      */
     public PhoneAccountHandle getAccountHandle() {
         return mAccountHandle;
     }

     /**
      * The address (e.g., a phone number) associated with this {@code PhoneAccount}. This
      * represents the destination from which outgoing calls using this {@code PhoneAccount}
      * will appear to come, if applicable, and the destination to which incoming calls using this
      * {@code PhoneAccount} may be addressed.
      *
      * @return A address expressed as a {@code Uri}, for example, a phone number.
      */
     public Uri getAddress() {
         return mAddress;
     }

     /**
      * The raw callback number used for this {@code PhoneAccount}, as distinct from
      * {@link #getAddress()}. For the majority of {@code PhoneAccount}s this should be registered
      * as {@code null}.  It is used by the system for SIM-based {@code PhoneAccount} registration
      * where {@link android.telephony.TelephonyManager#setLine1NumberForDisplay(String, String)}
      * has been used to alter the callback number.
      * <p>
      *
      * @return The subscription number, suitable for display to the user.
      */
     public Uri getSubscriptionAddress() {
         return mSubscriptionAddress;
     }

     /**
      * The capabilities of this {@code PhoneAccount}.
      *
      * @return A bit field of flags describing this {@code PhoneAccount}'s capabilities.
      */
     public int getCapabilities() {
         return mCapabilities;
     }

     /**
      * Determines if this {@code PhoneAccount} has a capabilities specified by the passed in
      * bit mask.
      *
      * @param capability The capabilities to check.
      * @return {@code True} if the phone account has the capability.
      */
     public boolean hasCapabilities(int capability) {
         return (mCapabilities & capability) == capability;
     }

     /**
      * A short label describing a {@code PhoneAccount}.
      *
      * @return A label for this {@code PhoneAccount}.
      */
     public CharSequence getLabel() {
         return mLabel;
     }

     /**
      * A short paragraph describing this {@code PhoneAccount}.
      *
      * @return A description for this {@code PhoneAccount}.
      */
     public CharSequence getShortDescription() {
         return mShortDescription;
     }

     /**
      * The URI schemes supported by this {@code PhoneAccount}.
      *
      * @return The URI schemes.
      */
     public List<String> getSupportedUriSchemes() {
         return mSupportedUriSchemes;
     }

     /**
      * Determines if the {@link PhoneAccount} supports calls to/from addresses with a specified URI
      * scheme.
      *
      * @param uriScheme The URI scheme to check.
      * @return {@code True} if the {@code PhoneAccount} supports calls to/from addresses with the
      * specified URI scheme.
      */
     public boolean supportsUriScheme(String uriScheme) {
         if (mSupportedUriSchemes == null || uriScheme == null) {
             return false;
         }

         for (String scheme : mSupportedUriSchemes) {
             if (scheme != null && scheme.equals(uriScheme)) {
                 return true;
             }
         }
         return false;
     }

     /**
      * The icon resource ID for the icon of this {@code PhoneAccount}.
      * <p>
      * Creators of a {@code PhoneAccount} who possess the icon in static resources should prefer
      * this method of indicating the icon rather than using {@link #getIconBitmap()}, since it
      * leads to less resource usage.
      * <p>
      * Clients wishing to display a {@code PhoneAccount} should use {@link #getIcon(Context)}.
      *
      * @return A resource ID.
      */
     public int getIconResId() {
         return mIconResId;
     }

     /**
      * The package name from which to load the icon of this {@code PhoneAccount}.
      * <p>
      * If this property is {@code null}, the resource {@link #getIconResId()} will be loaded from
      * the package in the {@link ComponentName} of the {@link #getAccountHandle()}.
      * <p>
      * Clients wishing to display a {@code PhoneAccount} should use {@link #getIcon(Context)}.
      *
      * @return A package name.
      */
     public String getIconPackageName() {
         return mIconPackageName;
     }

     /**
      * A highlight color to use in displaying information about this {@code PhoneAccount}.
      *
      * @return A hexadecimal color value.
      */
     public int getColor() {
         return mColor;
     }

     /**
      * A literal icon bitmap to represent this {@code PhoneAccount} in a user interface.
      * <p>
      * If this property is specified, it is to be considered the preferred icon. Otherwise, the
      * resource specified by {@link #getIconResId()} should be used.
      * <p>
      * Clients wishing to display a {@code PhoneAccount} should use {@link #getIcon(Context)}.
      *
      * @return A bitmap.
      */
     public Bitmap getIconBitmap() {
         return mIconBitmap;
     }

     /**
      * Builds and returns an icon {@code Drawable} to represent this {@code PhoneAccount} in a user
      * interface. Uses the properties {@link #getIconResId()}, {@link #getIconPackageName()}, and
      * {@link #getIconBitmap()} as necessary.
      *
      * @param context A {@code Context} to use for loading {@code Drawable}s.
      *
      * @return An icon for this {@code PhoneAccount}.
      */
     public Drawable getIcon(Context context) {
         if (mIconBitmap != null) {
             return new BitmapDrawable(context.getResources(), mIconBitmap);
         }

         if (mIconResId != 0) {
             String packageName = mIconPackageName == null
                     ? mAccountHandle.getComponentName().getPackageName()
                     : mIconPackageName;

             try {
                 Context packageContext = context.createPackageContext(packageName, 0);
                 try {
                     return packageContext.getDrawable(mIconResId);
                 } catch (NotFoundException | MissingResourceException e) {
                     Log.e(this, e, "Cannot find icon %d in package %s", mIconResId, packageName);
                 }
             } catch (PackageManager.NameNotFoundException e) {
                 Log.w(this, "Cannot find package %s", packageName);
             }
         }

         return new ColorDrawable(Color.TRANSPARENT);
     }

     //
     // Parcelable implementation
     //

     @Override
     public int describeContents() {
         return 0;
     }

     @Override
     public void writeToParcel(Parcel out, int flags) {
         out.writeParcelable(mAccountHandle, 0);
         out.writeParcelable(mAddress, 0);
         out.writeParcelable(mSubscriptionAddress, 0);
         out.writeInt(mCapabilities);
         out.writeInt(mIconResId);
         out.writeString(mIconPackageName);
         out.writeParcelable(mIconBitmap, 0);
         out.writeInt(mColor);
         out.writeCharSequence(mLabel);
         out.writeCharSequence(mShortDescription);
         out.writeList(mSupportedUriSchemes);
     }

     public static final Creator<PhoneAccount> CREATOR
             = new Creator<PhoneAccount>() {
         @Override
         public PhoneAccount createFromParcel(Parcel in) {
             return new PhoneAccount(in);
         }

         @Override
         public PhoneAccount[] newArray(int size) {
             return new PhoneAccount[size];
         }
     };

     private PhoneAccount(Parcel in) {
         ClassLoader classLoader = PhoneAccount.class.getClassLoader();

         mAccountHandle = in.readParcelable(getClass().getClassLoader());
         mAddress = in.readParcelable(getClass().getClassLoader());
         mSubscriptionAddress = in.readParcelable(getClass().getClassLoader());
         mCapabilities = in.readInt();
         mIconResId = in.readInt();
         mIconPackageName = in.readString();
         mIconBitmap = in.readParcelable(getClass().getClassLoader());
         mColor = in.readInt();
         mLabel = in.readCharSequence();
         mShortDescription = in.readCharSequence();

         List<String> supportedUriSchemes = new ArrayList<>();
         in.readList(supportedUriSchemes, classLoader);
         mSupportedUriSchemes = Collections.unmodifiableList(supportedUriSchemes);
     }

     @Override
     public String toString() {
         StringBuilder sb = new StringBuilder().append("[PhoneAccount: ")
                 .append(mAccountHandle)
                 .append(" Capabilities: ")
                 .append(mCapabilities)
                 .append(" Schemes: ");
         for (String scheme : mSupportedUriSchemes) {
             sb.append(scheme)
                     .append(" ");
         }
         sb.append("]");
         return sb.toString();
     }
 }
	/*
	* Copyright (C) 2014 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 android.telecom;

	import android.content.ComponentName;
	import android.content.Context;
	import android.content.pm.PackageManager;
	import android.content.res.Resources.NotFoundException;
	import android.graphics.Bitmap;
	import android.graphics.Color;
	import android.graphics.drawable.BitmapDrawable;
	import android.graphics.drawable.ColorDrawable;
	import android.graphics.drawable.Drawable;
	import android.net.Uri;
	import android.os.Parcel;
	import android.os.Parcelable;
	import android.text.TextUtils;

	import java.lang.String;
	import java.util.ArrayList;
	import java.util.Collections;
	import java.util.List;
	import java.util.MissingResourceException;

	/**
	* Represents a distinct method to place or receive a phone call. Apps which can place calls and
	* want those calls to be integrated into the dialer and in-call UI should build an instance of
	* this class and register it with the system using {@link TelecomManager#registerPhoneAccount}.
	* <p>
	* {@link TelecomManager} uses registered {@link PhoneAccount}s to present the user with
	* alternative options when placing a phone call. When building a {@link PhoneAccount}, the app
	* should supply a valid {@link PhoneAccountHandle} that references the {@link ConnectionService}
	* implementation Telecom will use to interact with the app.
	*/
	public class PhoneAccount implements Parcelable {

	/**
	* Flag indicating that this {@code PhoneAccount} can act as a connection manager for
	* other connections. The {@link ConnectionService} associated with this {@code PhoneAccount}
	* will be allowed to manage phone calls including using its own proprietary phone-call
	* implementation (like VoIP calling) to make calls instead of the telephony stack.
	* <p>
	* When a user opts to place a call using the SIM-based telephony stack, the
	* {@link ConnectionService} associated with this {@code PhoneAccount} will be attempted first
	* if the user has explicitly selected it to be used as the default connection manager.
	* <p>
	* See {@link #getCapabilities}
	*/
	public static final int CAPABILITY_CONNECTION_MANAGER = 0x1;

	/**
	* Flag indicating that this {@code PhoneAccount} can make phone calls in place of
	* traditional SIM-based telephony calls. This account will be treated as a distinct method
	* for placing calls alongside the traditional SIM-based telephony stack. This flag is
	* distinct from {@link #CAPABILITY_CONNECTION_MANAGER} in that it is not allowed to manage
	* or place calls from the built-in telephony stack.
	* <p>
	* See {@link #getCapabilities}
	* <p>
	* {@hide}
	*/
	public static final int CAPABILITY_CALL_PROVIDER = 0x2;

	/**
	* Flag indicating that this {@code PhoneAccount} represents a built-in PSTN SIM
	* subscription.
	* <p>
	* Only the Android framework can register a {@code PhoneAccount} having this capability.
	* <p>
	* See {@link #getCapabilities}
	*/
	public static final int CAPABILITY_SIM_SUBSCRIPTION = 0x4;

	/**
	* Flag indicating that this {@code PhoneAccount} is capable of placing video calls.
	* <p>
	* See {@link #getCapabilities}
	* @hide
	*/
	public static final int CAPABILITY_VIDEO_CALLING = 0x8;

	/**
	* Flag indicating that this {@code PhoneAccount} is capable of placing emergency calls.
	* By default all PSTN {@code PhoneAccount}s are capable of placing emergency calls.
	* <p>
	* See {@link #getCapabilities}
	*/
	public static final int CAPABILITY_PLACE_EMERGENCY_CALLS = 0x10;

	/**
	* URI scheme for telephone number URIs.
	*/
	public static final String SCHEME_TEL = "tel";

	/**
	* URI scheme for voicemail URIs.
	*/
	public static final String SCHEME_VOICEMAIL = "voicemail";

	/**
	* URI scheme for SIP URIs.
	*/
	public static final String SCHEME_SIP = "sip";

	/**
	* Indicating no color is set.
	*/
	public static final int NO_COLOR = -1;

	private final PhoneAccountHandle mAccountHandle;
	private final Uri mAddress;
	private final Uri mSubscriptionAddress;
	private final int mCapabilities;
	private final int mIconResId;
	private final String mIconPackageName;
	private final Bitmap mIconBitmap;
	private final int mColor;
	private final CharSequence mLabel;
	private final CharSequence mShortDescription;
	private final List<String> mSupportedUriSchemes;

	/**
	* Helper class for creating a {@link PhoneAccount}.
	*/
	public static class Builder {
	private PhoneAccountHandle mAccountHandle;
	private Uri mAddress;
	private Uri mSubscriptionAddress;
	private int mCapabilities;
	private int mIconResId;
	private String mIconPackageName;
	private Bitmap mIconBitmap;
	private int mColor = NO_COLOR;
	private CharSequence mLabel;
	private CharSequence mShortDescription;
	private List<String> mSupportedUriSchemes = new ArrayList<String>();

	/**
	* Creates a builder with the specified {@link PhoneAccountHandle} and label.
	*/
	public Builder(PhoneAccountHandle accountHandle, CharSequence label) {
	this.mAccountHandle = accountHandle;
	this.mLabel = label;
	}

	/**
	* Creates an instance of the {@link PhoneAccount.Builder} from an existing
	* {@link PhoneAccount}.
	*
	* @param phoneAccount The {@link PhoneAccount} used to initialize the builder.
	*/
	public Builder(PhoneAccount phoneAccount) {
	mAccountHandle = phoneAccount.getAccountHandle();
	mAddress = phoneAccount.getAddress();
	mSubscriptionAddress = phoneAccount.getSubscriptionAddress();
	mCapabilities = phoneAccount.getCapabilities();
	mIconResId = phoneAccount.getIconResId();
	mIconPackageName = phoneAccount.getIconPackageName();
	mIconBitmap = phoneAccount.getIconBitmap();
	mColor = phoneAccount.getColor();
	mLabel = phoneAccount.getLabel();
	mShortDescription = phoneAccount.getShortDescription();
	mSupportedUriSchemes.addAll(phoneAccount.getSupportedUriSchemes());
	}

	/**
	* Sets the address. See {@link PhoneAccount#getAddress}.
	*
	* @param value The address of the phone account.
	* @return The builder.
	*/
	public Builder setAddress(Uri value) {
	this.mAddress = value;
	return this;
	}

	/**
	* Sets the subscription address. See {@link PhoneAccount#getSubscriptionAddress}.
	*
	* @param value The subscription address.
	* @return The builder.
	*/
	public Builder setSubscriptionAddress(Uri value) {
	this.mSubscriptionAddress = value;
	return this;
	}

	/**
	* Sets the capabilities. See {@link PhoneAccount#getCapabilities}.
	*
	* @param value The capabilities to set.
	* @return The builder.
	*/
	public Builder setCapabilities(int value) {
	this.mCapabilities = value;
	return this;
	}

	/**
	* Sets the icon resource ID. See {@link PhoneAccount#getIconResId}.
	*
	* @param value The resource ID of the icon.
	* @return The builder.
	*/
	public Builder setIconResId(int value) {
	this.mIconResId = value;
	return this;
	}

	/**
	* Sets the icon package name. See {@link PhoneAccount#getIconPackageName}.
	*
	* @param value The name of the package from which to load the icon.
	* @return The builder.
	*/
	public Builder setIconPackageName(String value) {
	this.mIconPackageName = value;
	return this;
	}

	/**
	* Sets the icon bitmap. See {@link PhoneAccount#getIconBitmap}.
	*
	* @param value The icon bitmap.
	* @return The builder.
	*/
	public Builder setIconBitmap(Bitmap value) {
	this.mIconBitmap = value;
	return this;
	}

	/**
	* Sets the color. See {@link PhoneAccount#getColor}.
	*
	* @param value The resource ID of the icon.
	* @return The builder.
	*/
	public Builder setColor(int value) {
	this.mColor = value;
	return this;
	}

	/**
	* Sets the short description. See {@link PhoneAccount#getShortDescription}.
	*
	* @param value The short description.
	* @return The builder.
	*/
	public Builder setShortDescription(CharSequence value) {
	this.mShortDescription = value;
	return this;
	}

	/**
	* Specifies an additional URI scheme supported by the {@link PhoneAccount}.
	*
	* @param uriScheme The URI scheme.
	* @return The builder.
	* @hide
	*/
	public Builder addSupportedUriScheme(String uriScheme) {
	if (!TextUtils.isEmpty(uriScheme) && !mSupportedUriSchemes.contains(uriScheme)) {
	this.mSupportedUriSchemes.add(uriScheme);
	}
	return this;
	}

	/**
	* Specifies the URI schemes supported by the {@link PhoneAccount}.
	*
	* @param uriSchemes The URI schemes.
	* @return The builder.
	*/
	public Builder setSupportedUriSchemes(List<String> uriSchemes) {
	mSupportedUriSchemes.clear();

	if (uriSchemes != null && !uriSchemes.isEmpty()) {
	for (String uriScheme : uriSchemes) {
	addSupportedUriScheme(uriScheme);
	}
	}
	return this;
	}

	/**
	* Creates an instance of a {@link PhoneAccount} based on the current builder settings.
	*
	* @return The {@link PhoneAccount}.
	*/
	public PhoneAccount build() {
	// If no supported URI schemes were defined, assume "tel" is supported.
	if (mSupportedUriSchemes.isEmpty()) {
	addSupportedUriScheme(SCHEME_TEL);
	}

	return new PhoneAccount(
	mAccountHandle,
	mAddress,
	mSubscriptionAddress,
	mCapabilities,
	mIconResId,
	mIconPackageName,
	mIconBitmap,
	mColor,
	mLabel,
	mShortDescription,
	mSupportedUriSchemes);
	}
	}

	private PhoneAccount(
	PhoneAccountHandle account,
	Uri address,
	Uri subscriptionAddress,
	int capabilities,
	int iconResId,
	String iconPackageName,
	Bitmap iconBitmap,
	int color,
	CharSequence label,
	CharSequence shortDescription,
	List<String> supportedUriSchemes) {
	mAccountHandle = account;
	mAddress = address;
	mSubscriptionAddress = subscriptionAddress;
	mCapabilities = capabilities;
	mIconResId = iconResId;
	mIconPackageName = iconPackageName;
	mIconBitmap = iconBitmap;
	mColor = color;
	mLabel = label;
	mShortDescription = shortDescription;
	mSupportedUriSchemes = Collections.unmodifiableList(supportedUriSchemes);
	}

	public static Builder builder(
	PhoneAccountHandle accountHandle,
	CharSequence label) {
	return new Builder(accountHandle, label);
	}

	/**
	* Returns a builder initialized with the current {@link PhoneAccount} instance.
	*
	* @return The builder.
	* @hide
	*/
	public Builder toBuilder() { return new Builder(this); }

	/**
	* The unique identifier of this {@code PhoneAccount}.
	*
	* @return A {@code PhoneAccountHandle}.
	*/
	public PhoneAccountHandle getAccountHandle() {
	return mAccountHandle;
	}

	/**
	* The address (e.g., a phone number) associated with this {@code PhoneAccount}. This
	* represents the destination from which outgoing calls using this {@code PhoneAccount}
	* will appear to come, if applicable, and the destination to which incoming calls using this
	* {@code PhoneAccount} may be addressed.
	*
	* @return A address expressed as a {@code Uri}, for example, a phone number.
	*/
	public Uri getAddress() {
	return mAddress;
	}

	/**
	* The raw callback number used for this {@code PhoneAccount}, as distinct from
	* {@link #getAddress()}. For the majority of {@code PhoneAccount}s this should be registered
	* as {@code null}. It is used by the system for SIM-based {@code PhoneAccount} registration
	* where {@link android.telephony.TelephonyManager#setLine1NumberForDisplay(String, String)}
	* has been used to alter the callback number.
	* <p>
	*
	* @return The subscription number, suitable for display to the user.
	*/
	public Uri getSubscriptionAddress() {
	return mSubscriptionAddress;
	}

	/**
	* The capabilities of this {@code PhoneAccount}.
	*
	* @return A bit field of flags describing this {@code PhoneAccount}'s capabilities.
	*/
	public int getCapabilities() {
	return mCapabilities;
	}

	/**
	* Determines if this {@code PhoneAccount} has a capabilities specified by the passed in
	* bit mask.
	*
	* @param capability The capabilities to check.
	* @return {@code True} if the phone account has the capability.
	*/
	public boolean hasCapabilities(int capability) {
	return (mCapabilities & capability) == capability;
	}

	/**
	* A short label describing a {@code PhoneAccount}.
	*
	* @return A label for this {@code PhoneAccount}.
	*/
	public CharSequence getLabel() {
	return mLabel;
	}

	/**
	* A short paragraph describing this {@code PhoneAccount}.
	*
	* @return A description for this {@code PhoneAccount}.
	*/
	public CharSequence getShortDescription() {
	return mShortDescription;
	}

	/**
	* The URI schemes supported by this {@code PhoneAccount}.
	*
	* @return The URI schemes.
	*/
	public List<String> getSupportedUriSchemes() {
	return mSupportedUriSchemes;
	}

	/**
	* Determines if the {@link PhoneAccount} supports calls to/from addresses with a specified URI
	* scheme.
	*
	* @param uriScheme The URI scheme to check.
	* @return {@code True} if the {@code PhoneAccount} supports calls to/from addresses with the
	* specified URI scheme.
	*/
	public boolean supportsUriScheme(String uriScheme) {
	if (mSupportedUriSchemes == null \|\| uriScheme == null) {
	return false;
	}

	for (String scheme : mSupportedUriSchemes) {
	if (scheme != null && scheme.equals(uriScheme)) {
	return true;
	}
	}
	return false;
	}

	/**
	* The icon resource ID for the icon of this {@code PhoneAccount}.
	* <p>
	* Creators of a {@code PhoneAccount} who possess the icon in static resources should prefer
	* this method of indicating the icon rather than using {@link #getIconBitmap()}, since it
	* leads to less resource usage.
	* <p>
	* Clients wishing to display a {@code PhoneAccount} should use {@link #getIcon(Context)}.
	*
	* @return A resource ID.
	*/
	public int getIconResId() {
	return mIconResId;
	}

	/**
	* The package name from which to load the icon of this {@code PhoneAccount}.
	* <p>
	* If this property is {@code null}, the resource {@link #getIconResId()} will be loaded from
	* the package in the {@link ComponentName} of the {@link #getAccountHandle()}.
	* <p>
	* Clients wishing to display a {@code PhoneAccount} should use {@link #getIcon(Context)}.
	*
	* @return A package name.
	*/
	public String getIconPackageName() {
	return mIconPackageName;
	}

	/**
	* A highlight color to use in displaying information about this {@code PhoneAccount}.
	*
	* @return A hexadecimal color value.
	*/
	public int getColor() {
	return mColor;
	}

	/**
	* A literal icon bitmap to represent this {@code PhoneAccount} in a user interface.
	* <p>
	* If this property is specified, it is to be considered the preferred icon. Otherwise, the
	* resource specified by {@link #getIconResId()} should be used.
	* <p>
	* Clients wishing to display a {@code PhoneAccount} should use {@link #getIcon(Context)}.
	*
	* @return A bitmap.
	*/
	public Bitmap getIconBitmap() {
	return mIconBitmap;
	}

	/**
	* Builds and returns an icon {@code Drawable} to represent this {@code PhoneAccount} in a user
	* interface. Uses the properties {@link #getIconResId()}, {@link #getIconPackageName()}, and
	* {@link #getIconBitmap()} as necessary.
	*
	* @param context A {@code Context} to use for loading {@code Drawable}s.
	*
	* @return An icon for this {@code PhoneAccount}.
	*/
	public Drawable getIcon(Context context) {
	if (mIconBitmap != null) {
	return new BitmapDrawable(context.getResources(), mIconBitmap);
	}

	if (mIconResId != 0) {
	String packageName = mIconPackageName == null
	? mAccountHandle.getComponentName().getPackageName()
	: mIconPackageName;

	try {
	Context packageContext = context.createPackageContext(packageName, 0);
	try {
	return packageContext.getDrawable(mIconResId);
	} catch (NotFoundException \| MissingResourceException e) {
	Log.e(this, e, "Cannot find icon %d in package %s", mIconResId, packageName);
	}
	} catch (PackageManager.NameNotFoundException e) {
	Log.w(this, "Cannot find package %s", packageName);
	}
	}

	return new ColorDrawable(Color.TRANSPARENT);
	}

	//
	// Parcelable implementation
	//

	@Override
	public int describeContents() {
	return 0;
	}

	@Override
	public void writeToParcel(Parcel out, int flags) {
	out.writeParcelable(mAccountHandle, 0);
	out.writeParcelable(mAddress, 0);
	out.writeParcelable(mSubscriptionAddress, 0);
	out.writeInt(mCapabilities);
	out.writeInt(mIconResId);
	out.writeString(mIconPackageName);
	out.writeParcelable(mIconBitmap, 0);
	out.writeInt(mColor);
	out.writeCharSequence(mLabel);
	out.writeCharSequence(mShortDescription);
	out.writeList(mSupportedUriSchemes);
	}

	public static final Creator<PhoneAccount> CREATOR
	= new Creator<PhoneAccount>() {
	@Override
	public PhoneAccount createFromParcel(Parcel in) {
	return new PhoneAccount(in);
	}

	@Override
	public PhoneAccount[] newArray(int size) {
	return new PhoneAccount[size];
	}
	};

	private PhoneAccount(Parcel in) {
	ClassLoader classLoader = PhoneAccount.class.getClassLoader();

	mAccountHandle = in.readParcelable(getClass().getClassLoader());
	mAddress = in.readParcelable(getClass().getClassLoader());
	mSubscriptionAddress = in.readParcelable(getClass().getClassLoader());
	mCapabilities = in.readInt();
	mIconResId = in.readInt();
	mIconPackageName = in.readString();
	mIconBitmap = in.readParcelable(getClass().getClassLoader());
	mColor = in.readInt();
	mLabel = in.readCharSequence();
	mShortDescription = in.readCharSequence();

	List<String> supportedUriSchemes = new ArrayList<>();
	in.readList(supportedUriSchemes, classLoader);
	mSupportedUriSchemes = Collections.unmodifiableList(supportedUriSchemes);
	}

	@Override
	public String toString() {
	StringBuilder sb = new StringBuilder().append("[PhoneAccount: ")
	.append(mAccountHandle)
	.append(" Capabilities: ")
	.append(mCapabilities)
	.append(" Schemes: ");
	for (String scheme : mSupportedUriSchemes) {
	sb.append(scheme)
	.append(" ");
	}
	sb.append("]");
	return sb.toString();
	}
	}