src/com/android/incallui/Call.java - platform/packages/apps/InCallUI - Git at Google

 /*
  * Copyright (C) 2013 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.incallui;

 import android.net.Uri;
 import android.telecomm.PhoneCapabilities;
 import android.telecomm.GatewayInfo;
 import android.telecomm.InCallService.VideoCall;
 import android.telecomm.PhoneAccountHandle;
 import android.telecomm.VideoProfile;
 import android.telephony.DisconnectCause;

 import java.util.ArrayList;
 import java.util.List;
 import java.util.Locale;

 /**
  * Describes a single call and its state.
  */
 public final class Call {
     /* Defines different states of this call */
     public static class State {
         public static final int INVALID = 0;
         public static final int IDLE = 1;           /* The call is idle.  Nothing active */
         public static final int ACTIVE = 2;         /* There is an active call */
         public static final int INCOMING = 3;       /* A normal incoming phone call */
         public static final int CALL_WAITING = 4;   /* Incoming call while another is active */
         public static final int DIALING = 5;        /* An outgoing call during dial phase */
         public static final int REDIALING = 6;      /* Subsequent dialing attempt after a failure */
         public static final int ONHOLD = 7;         /* An active phone call placed on hold */
         public static final int DISCONNECTING = 8;  /* A call is being ended. */
         public static final int DISCONNECTED = 9;   /* State after a call disconnects */
         public static final int CONFERENCED = 10;   /* Call part of a conference call */
         public static final int PRE_DIAL_WAIT = 11; /* Waiting for user before outgoing call */
         public static final int CONNECTING = 12;    /* Waiting for Telecomm broadcast to finish */

         public static boolean isConnectingOrConnected(int state) {
             switch(state) {
                 case ACTIVE:
                 case INCOMING:
                 case CALL_WAITING:
                 case CONNECTING:
                 case DIALING:
                 case REDIALING:
                 case ONHOLD:
                 case CONFERENCED:
                     return true;
                 default:
             }
             return false;
         }

         public static boolean isDialing(int state) {
             return state == DIALING || state == REDIALING;
         }

         public static String toString(int state) {
             switch (state) {
                 case INVALID:
                     return "INVALID";
                 case IDLE:
                     return "IDLE";
                 case ACTIVE:
                     return "ACTIVE";
                 case INCOMING:
                     return "INCOMING";
                 case CALL_WAITING:
                     return "CALL_WAITING";
                 case DIALING:
                     return "DIALING";
                 case REDIALING:
                     return "REDIALING";
                 case ONHOLD:
                     return "ONHOLD";
                 case DISCONNECTING:
                     return "DISCONNECTING";
                 case DISCONNECTED:
                     return "DISCONNECTED";
                 case CONFERENCED:
                     return "CONFERENCED";
                 case PRE_DIAL_WAIT:
                     return "PRE_DIAL_WAIT";
                 case CONNECTING:
                     return "CONNECTING";
                 default:
                     return "UNKNOWN";
             }
         }
     }

     /**
      * Defines different states of session modify requests, which are used to upgrade to video, or
      * downgrade to audio.
      */
     public static class SessionModificationState {
         public static final int NO_REQUEST = 0;
         public static final int WAITING_FOR_RESPONSE = 1;
         public static final int REQUEST_FAILED = 2;
         public static final int RECEIVED_UPGRADE_TO_VIDEO_REQUEST = 3;
     }

     private static final String ID_PREFIX = Call.class.getSimpleName() + "_";
     private static int sIdCounter = 0;

     private android.telecomm.Call.Listener mTelecommCallListener =
             new android.telecomm.Call.Listener() {
                 @Override
                 public void onStateChanged(android.telecomm.Call call, int newState) {
                     update();
                 }

                 @Override
                 public void onParentChanged(android.telecomm.Call call,
                         android.telecomm.Call newParent) {
                     update();
                 }

                 @Override
                 public void onChildrenChanged(android.telecomm.Call call,
                         List<android.telecomm.Call> children) {
                     update();
                 }

                 @Override
                 public void onDetailsChanged(android.telecomm.Call call,
                         android.telecomm.Call.Details details) {
                     update();
                 }

                 @Override
                 public void onCannedTextResponsesLoaded(android.telecomm.Call call,
                         List<String> cannedTextResponses) {
                     update();
                 }

                 @Override
                 public void onPostDialWait(android.telecomm.Call call,
                         String remainingPostDialSequence) {
                     update();
                 }

                 @Override
                 public void onVideoCallChanged(android.telecomm.Call call,
                         VideoCall videoCall) {
                     update();
                 }

                 @Override
                 public void onCallDestroyed(android.telecomm.Call call) {
                     call.removeListener(mTelecommCallListener);
                 }
             };

     private final android.telecomm.Call mTelecommCall;
     private final String mId;
     private int mState = State.INVALID;
     private int mDisconnectCause;
     private int mSessionModificationState;
     private final List<String> mChildCallIds = new ArrayList<>();

     private InCallVideoCallListener mVideoCallListener;

     public Call(android.telecomm.Call telecommCall) {
         mTelecommCall = telecommCall;
         mId = ID_PREFIX + Integer.toString(sIdCounter++);
         updateFromTelecommCall();
         if (getState() == Call.State.INCOMING) {
             CallList.getInstance().onIncoming(this, getCannedSmsResponses());
         } else {
             CallList.getInstance().onUpdate(this);
         }
         mTelecommCall.addListener(mTelecommCallListener);
     }

     public android.telecomm.Call getTelecommCall() {
         return mTelecommCall;
     }

     private void update() {
         int oldState = getState();
         updateFromTelecommCall();
         if (oldState != getState() && getState() == Call.State.DISCONNECTED) {
             CallList.getInstance().onDisconnect(this);
         } else {
             CallList.getInstance().onUpdate(this);
         }
     }

     private void updateFromTelecommCall() {
         setState(translateState(mTelecommCall.getState()));
         setDisconnectCause(mTelecommCall.getDetails().getDisconnectCauseCode());

         if (mTelecommCall.getVideoCall() != null) {
             if (mVideoCallListener == null) {
                 mVideoCallListener = new InCallVideoCallListener(this);
             }
             mTelecommCall.getVideoCall().setVideoCallListener(mVideoCallListener);
         }

         mChildCallIds.clear();
         for (int i = 0; i < mTelecommCall.getChildren().size(); i++) {
             mChildCallIds.add(
                     CallList.getInstance().getCallByTelecommCall(
                             mTelecommCall.getChildren().get(i)).getId());
         }
     }

     private static int translateState(int state) {
         switch (state) {
             case android.telecomm.Call.STATE_CONNECTING:
                 return Call.State.CONNECTING;
             case android.telecomm.Call.STATE_PRE_DIAL_WAIT:
                 return Call.State.PRE_DIAL_WAIT;
             case android.telecomm.Call.STATE_DIALING:
             case android.telecomm.Call.STATE_NEW:
                 return Call.State.DIALING;
             case android.telecomm.Call.STATE_RINGING:
                 return Call.State.INCOMING;
             case android.telecomm.Call.STATE_ACTIVE:
                 return Call.State.ACTIVE;
             case android.telecomm.Call.STATE_HOLDING:
                 return Call.State.ONHOLD;
             case android.telecomm.Call.STATE_DISCONNECTED:
                 return Call.State.DISCONNECTED;
             default:
                 return Call.State.INVALID;
         }
     }

     public String getId() {
         return mId;
     }

     public String getNumber() {
         if (mTelecommCall.getDetails().getGatewayInfo() != null) {
             return mTelecommCall.getDetails().getGatewayInfo()
                     .getOriginalHandle().getSchemeSpecificPart();
         }
         return getHandle() == null ? null : getHandle().getSchemeSpecificPart();
     }

     public Uri getHandle() {
         return mTelecommCall.getDetails().getHandle();
     }

     public int getState() {
         if (mTelecommCall.getParent() != null) {
             return State.CONFERENCED;
         } else {
             return mState;
         }
     }

     public void setState(int state) {
         mState = state;
     }

     public int getNumberPresentation() {
         return getTelecommCall().getDetails().getHandlePresentation();
     }

     public int getCnapNamePresentation() {
         return getTelecommCall().getDetails().getCallerDisplayNamePresentation();
     }

     public String getCnapName() {
         return getTelecommCall().getDetails().getCallerDisplayName();
     }

     /** Returns call disconnect cause; values are defined in {@link DisconnectCause}. */
     public int getDisconnectCause() {
         if (mState == State.DISCONNECTED || mState == State.IDLE) {
             return mDisconnectCause;
         }

         return DisconnectCause.NOT_DISCONNECTED;
     }

     public void setDisconnectCause(int disconnectCause) {
         mDisconnectCause = disconnectCause;
     }

     /** Returns the possible text message responses. */
     public List<String> getCannedSmsResponses() {
         return mTelecommCall.getCannedTextResponses();
     }

     /** Checks if the call supports the given set of capabilities supplied as a bit mask. */
     public boolean can(int capabilities) {
         if (PhoneCapabilities.MERGE_CALLS == (capabilities & PhoneCapabilities.MERGE_CALLS)) {
             if (mTelecommCall.getConferenceableCalls().isEmpty()) {
                 // Cannot merge calls if there are no calls to merge with.
                 return false;
             }
             capabilities &= ~PhoneCapabilities.MERGE_CALLS;
         }
         return (capabilities == (capabilities & mTelecommCall.getDetails().getCallCapabilities()));
     }

     /** Gets the time when the call first became active. */
     public long getConnectTimeMillis() {
         return mTelecommCall.getDetails().getConnectTimeMillis();
     }

     public boolean isConferenceCall() {
         return mChildCallIds != null && !mChildCallIds.isEmpty();
     }

     public GatewayInfo getGatewayInfo() {
         return mTelecommCall.getDetails().getGatewayInfo();
     }

     public PhoneAccountHandle getAccountHandle() {
         return mTelecommCall.getDetails().getAccountHandle();
     }

     public VideoCall getVideoCall() {
         return mTelecommCall.getVideoCall();
     }

     public List<String> getChildCallIds() {
         return mChildCallIds;
     }

     public String getParentId() {
         android.telecomm.Call parentCall = mTelecommCall.getParent();
         if (parentCall != null) {
             return CallList.getInstance().getCallByTelecommCall(parentCall).getId();
         }
         return null;
     }

     public int getVideoState() {
         return mTelecommCall.getDetails().getVideoState();
     }

     public boolean isVideoCall() {
         return VideoProfile.VideoState.isBidirectional(getVideoState());
     }

     public void setSessionModificationState(int state) {
         boolean hasChanged = mSessionModificationState != state;
         mSessionModificationState = state;

         if (hasChanged) {
             update();
         }
     }

     public static boolean areSame(Call call1, Call call2) {
         if (call1 == null && call2 == null) {
             return true;
         } else if (call1 == null || call2 == null) {
             return false;
         }

         // otherwise compare call Ids
         return call1.getId().equals(call2.getId());
     }

     public int getSessionModificationState() {
         return mSessionModificationState;
     }

     @Override
     public String toString() {
         return String.format(Locale.US, "[%s, %s, %s, children:%s, parent:%s, videoState:%d]",
                 mId,
                 State.toString(mState),
                 PhoneCapabilities.toString(mTelecommCall.getDetails().getCallCapabilities()),
                 mChildCallIds,
                 getParentId(),
                 mTelecommCall.getDetails().getVideoState());
     }
 }
	/*
	* Copyright (C) 2013 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.incallui;

	import android.net.Uri;
	import android.telecomm.PhoneCapabilities;
	import android.telecomm.GatewayInfo;
	import android.telecomm.InCallService.VideoCall;
	import android.telecomm.PhoneAccountHandle;
	import android.telecomm.VideoProfile;
	import android.telephony.DisconnectCause;

	import java.util.ArrayList;
	import java.util.List;
	import java.util.Locale;

	/**
	* Describes a single call and its state.
	*/
	public final class Call {
	/* Defines different states of this call */
	public static class State {
	public static final int INVALID = 0;
	public static final int IDLE = 1; /* The call is idle. Nothing active */
	public static final int ACTIVE = 2; /* There is an active call */
	public static final int INCOMING = 3; /* A normal incoming phone call */
	public static final int CALL_WAITING = 4; /* Incoming call while another is active */
	public static final int DIALING = 5; /* An outgoing call during dial phase */
	public static final int REDIALING = 6; /* Subsequent dialing attempt after a failure */
	public static final int ONHOLD = 7; /* An active phone call placed on hold */
	public static final int DISCONNECTING = 8; /* A call is being ended. */
	public static final int DISCONNECTED = 9; /* State after a call disconnects */
	public static final int CONFERENCED = 10; /* Call part of a conference call */
	public static final int PRE_DIAL_WAIT = 11; /* Waiting for user before outgoing call */
	public static final int CONNECTING = 12; /* Waiting for Telecomm broadcast to finish */

	public static boolean isConnectingOrConnected(int state) {
	switch(state) {
	case ACTIVE:
	case INCOMING:
	case CALL_WAITING:
	case CONNECTING:
	case DIALING:
	case REDIALING:
	case ONHOLD:
	case CONFERENCED:
	return true;
	default:
	}
	return false;
	}

	public static boolean isDialing(int state) {
	return state == DIALING \|\| state == REDIALING;
	}

	public static String toString(int state) {
	switch (state) {
	case INVALID:
	return "INVALID";
	case IDLE:
	return "IDLE";
	case ACTIVE:
	return "ACTIVE";
	case INCOMING:
	return "INCOMING";
	case CALL_WAITING:
	return "CALL_WAITING";
	case DIALING:
	return "DIALING";
	case REDIALING:
	return "REDIALING";
	case ONHOLD:
	return "ONHOLD";
	case DISCONNECTING:
	return "DISCONNECTING";
	case DISCONNECTED:
	return "DISCONNECTED";
	case CONFERENCED:
	return "CONFERENCED";
	case PRE_DIAL_WAIT:
	return "PRE_DIAL_WAIT";
	case CONNECTING:
	return "CONNECTING";
	default:
	return "UNKNOWN";
	}
	}
	}

	/**
	* Defines different states of session modify requests, which are used to upgrade to video, or
	* downgrade to audio.
	*/
	public static class SessionModificationState {
	public static final int NO_REQUEST = 0;
	public static final int WAITING_FOR_RESPONSE = 1;
	public static final int REQUEST_FAILED = 2;
	public static final int RECEIVED_UPGRADE_TO_VIDEO_REQUEST = 3;
	}

	private static final String ID_PREFIX = Call.class.getSimpleName() + "_";
	private static int sIdCounter = 0;

	private android.telecomm.Call.Listener mTelecommCallListener =
	new android.telecomm.Call.Listener() {
	@Override
	public void onStateChanged(android.telecomm.Call call, int newState) {
	update();
	}

	@Override
	public void onParentChanged(android.telecomm.Call call,
	android.telecomm.Call newParent) {
	update();
	}

	@Override
	public void onChildrenChanged(android.telecomm.Call call,
	List<android.telecomm.Call> children) {
	update();
	}

	@Override
	public void onDetailsChanged(android.telecomm.Call call,
	android.telecomm.Call.Details details) {
	update();
	}

	@Override
	public void onCannedTextResponsesLoaded(android.telecomm.Call call,
	List<String> cannedTextResponses) {
	update();
	}

	@Override
	public void onPostDialWait(android.telecomm.Call call,
	String remainingPostDialSequence) {
	update();
	}

	@Override
	public void onVideoCallChanged(android.telecomm.Call call,
	VideoCall videoCall) {
	update();
	}

	@Override
	public void onCallDestroyed(android.telecomm.Call call) {
	call.removeListener(mTelecommCallListener);
	}
	};

	private final android.telecomm.Call mTelecommCall;
	private final String mId;
	private int mState = State.INVALID;
	private int mDisconnectCause;
	private int mSessionModificationState;
	private final List<String> mChildCallIds = new ArrayList<>();

	private InCallVideoCallListener mVideoCallListener;

	public Call(android.telecomm.Call telecommCall) {
	mTelecommCall = telecommCall;
	mId = ID_PREFIX + Integer.toString(sIdCounter++);
	updateFromTelecommCall();
	if (getState() == Call.State.INCOMING) {
	CallList.getInstance().onIncoming(this, getCannedSmsResponses());
	} else {
	CallList.getInstance().onUpdate(this);
	}
	mTelecommCall.addListener(mTelecommCallListener);
	}

	public android.telecomm.Call getTelecommCall() {
	return mTelecommCall;
	}

	private void update() {
	int oldState = getState();
	updateFromTelecommCall();
	if (oldState != getState() && getState() == Call.State.DISCONNECTED) {
	CallList.getInstance().onDisconnect(this);
	} else {
	CallList.getInstance().onUpdate(this);
	}
	}

	private void updateFromTelecommCall() {
	setState(translateState(mTelecommCall.getState()));
	setDisconnectCause(mTelecommCall.getDetails().getDisconnectCauseCode());

	if (mTelecommCall.getVideoCall() != null) {
	if (mVideoCallListener == null) {
	mVideoCallListener = new InCallVideoCallListener(this);
	}
	mTelecommCall.getVideoCall().setVideoCallListener(mVideoCallListener);
	}

	mChildCallIds.clear();
	for (int i = 0; i < mTelecommCall.getChildren().size(); i++) {
	mChildCallIds.add(
	CallList.getInstance().getCallByTelecommCall(
	mTelecommCall.getChildren().get(i)).getId());
	}
	}

	private static int translateState(int state) {
	switch (state) {
	case android.telecomm.Call.STATE_CONNECTING:
	return Call.State.CONNECTING;
	case android.telecomm.Call.STATE_PRE_DIAL_WAIT:
	return Call.State.PRE_DIAL_WAIT;
	case android.telecomm.Call.STATE_DIALING:
	case android.telecomm.Call.STATE_NEW:
	return Call.State.DIALING;
	case android.telecomm.Call.STATE_RINGING:
	return Call.State.INCOMING;
	case android.telecomm.Call.STATE_ACTIVE:
	return Call.State.ACTIVE;
	case android.telecomm.Call.STATE_HOLDING:
	return Call.State.ONHOLD;
	case android.telecomm.Call.STATE_DISCONNECTED:
	return Call.State.DISCONNECTED;
	default:
	return Call.State.INVALID;
	}
	}

	public String getId() {
	return mId;
	}

	public String getNumber() {
	if (mTelecommCall.getDetails().getGatewayInfo() != null) {
	return mTelecommCall.getDetails().getGatewayInfo()
	.getOriginalHandle().getSchemeSpecificPart();
	}
	return getHandle() == null ? null : getHandle().getSchemeSpecificPart();
	}

	public Uri getHandle() {
	return mTelecommCall.getDetails().getHandle();
	}

	public int getState() {
	if (mTelecommCall.getParent() != null) {
	return State.CONFERENCED;
	} else {
	return mState;
	}
	}

	public void setState(int state) {
	mState = state;
	}

	public int getNumberPresentation() {
	return getTelecommCall().getDetails().getHandlePresentation();
	}

	public int getCnapNamePresentation() {
	return getTelecommCall().getDetails().getCallerDisplayNamePresentation();
	}

	public String getCnapName() {
	return getTelecommCall().getDetails().getCallerDisplayName();
	}

	/** Returns call disconnect cause; values are defined in {@link DisconnectCause}. */
	public int getDisconnectCause() {
	if (mState == State.DISCONNECTED \|\| mState == State.IDLE) {
	return mDisconnectCause;
	}

	return DisconnectCause.NOT_DISCONNECTED;
	}

	public void setDisconnectCause(int disconnectCause) {
	mDisconnectCause = disconnectCause;
	}

	/** Returns the possible text message responses. */
	public List<String> getCannedSmsResponses() {
	return mTelecommCall.getCannedTextResponses();
	}

	/** Checks if the call supports the given set of capabilities supplied as a bit mask. */
	public boolean can(int capabilities) {
	if (PhoneCapabilities.MERGE_CALLS == (capabilities & PhoneCapabilities.MERGE_CALLS)) {
	if (mTelecommCall.getConferenceableCalls().isEmpty()) {
	// Cannot merge calls if there are no calls to merge with.
	return false;
	}
	capabilities &= ~PhoneCapabilities.MERGE_CALLS;
	}
	return (capabilities == (capabilities & mTelecommCall.getDetails().getCallCapabilities()));
	}

	/** Gets the time when the call first became active. */
	public long getConnectTimeMillis() {
	return mTelecommCall.getDetails().getConnectTimeMillis();
	}

	public boolean isConferenceCall() {
	return mChildCallIds != null && !mChildCallIds.isEmpty();
	}

	public GatewayInfo getGatewayInfo() {
	return mTelecommCall.getDetails().getGatewayInfo();
	}

	public PhoneAccountHandle getAccountHandle() {
	return mTelecommCall.getDetails().getAccountHandle();
	}

	public VideoCall getVideoCall() {
	return mTelecommCall.getVideoCall();
	}

	public List<String> getChildCallIds() {
	return mChildCallIds;
	}

	public String getParentId() {
	android.telecomm.Call parentCall = mTelecommCall.getParent();
	if (parentCall != null) {
	return CallList.getInstance().getCallByTelecommCall(parentCall).getId();
	}
	return null;
	}

	public int getVideoState() {
	return mTelecommCall.getDetails().getVideoState();
	}

	public boolean isVideoCall() {
	return VideoProfile.VideoState.isBidirectional(getVideoState());
	}

	public void setSessionModificationState(int state) {
	boolean hasChanged = mSessionModificationState != state;
	mSessionModificationState = state;

	if (hasChanged) {
	update();
	}
	}

	public static boolean areSame(Call call1, Call call2) {
	if (call1 == null && call2 == null) {
	return true;
	} else if (call1 == null \|\| call2 == null) {
	return false;
	}

	// otherwise compare call Ids
	return call1.getId().equals(call2.getId());
	}

	public int getSessionModificationState() {
	return mSessionModificationState;
	}

	@Override
	public String toString() {
	return String.format(Locale.US, "[%s, %s, %s, children:%s, parent:%s, videoState:%d]",
	mId,
	State.toString(mState),
	PhoneCapabilities.toString(mTelecommCall.getDetails().getCallCapabilities()),
	mChildCallIds,
	getParentId(),
	mTelecommCall.getDetails().getVideoState());
	}
	}