410 lines
17 KiB
Java
410 lines
17 KiB
Java
/*
|
|
* 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.annotation.Nullable;
|
|
import android.media.ToneGenerator;
|
|
import android.os.Parcel;
|
|
import android.os.Parcelable;
|
|
import android.telephony.Annotation;
|
|
import android.telephony.PreciseDisconnectCause;
|
|
import android.telephony.ims.ImsReasonInfo;
|
|
import android.text.TextUtils;
|
|
|
|
import java.util.Objects;
|
|
|
|
/**
|
|
* Describes the cause of a disconnected call. This always includes a code describing the generic
|
|
* cause of the disconnect. Optionally, it may include a label and/or description to display to the
|
|
* user. It is the responsibility of the {@link ConnectionService} to provide localized versions of
|
|
* the label and description. It also may contain a reason for the disconnect, which is intended for
|
|
* logging and not for display to the user.
|
|
*/
|
|
public final class DisconnectCause implements Parcelable {
|
|
|
|
/** Disconnected because of an unknown or unspecified reason. */
|
|
public static final int UNKNOWN = TelecomProtoEnums.UNKNOWN; // = 0
|
|
/** Disconnected because there was an error, such as a problem with the network. */
|
|
public static final int ERROR = TelecomProtoEnums.ERROR; // = 1
|
|
/** Disconnected because of a local user-initiated action, such as hanging up. */
|
|
public static final int LOCAL = TelecomProtoEnums.LOCAL; // = 2
|
|
/**
|
|
* Disconnected because of a remote user-initiated action, such as the other party hanging up
|
|
* up.
|
|
*/
|
|
public static final int REMOTE = TelecomProtoEnums.REMOTE; // = 3
|
|
/** Disconnected because it has been canceled. */
|
|
public static final int CANCELED = TelecomProtoEnums.CANCELED; // = 4
|
|
/** Disconnected because there was no response to an incoming call. */
|
|
public static final int MISSED = TelecomProtoEnums.MISSED; // = 5
|
|
/** Disconnected because the user rejected an incoming call. */
|
|
public static final int REJECTED = TelecomProtoEnums.REJECTED; // = 6
|
|
/** Disconnected because the other party was busy. */
|
|
public static final int BUSY = TelecomProtoEnums.BUSY; // = 7
|
|
/**
|
|
* Disconnected because of a restriction on placing the call, such as dialing in airplane
|
|
* mode.
|
|
*/
|
|
public static final int RESTRICTED = TelecomProtoEnums.RESTRICTED; // = 8
|
|
/** Disconnected for reason not described by other disconnect codes. */
|
|
public static final int OTHER = TelecomProtoEnums.OTHER; // = 9
|
|
/**
|
|
* Disconnected because the connection manager did not support the call. The call will be tried
|
|
* again without a connection manager. See {@link PhoneAccount#CAPABILITY_CONNECTION_MANAGER}.
|
|
*/
|
|
public static final int CONNECTION_MANAGER_NOT_SUPPORTED =
|
|
TelecomProtoEnums.CONNECTION_MANAGER_NOT_SUPPORTED; // = 10
|
|
|
|
/**
|
|
* Disconnected because the user did not locally answer the incoming call, but it was answered
|
|
* on another device where the call was ringing.
|
|
*/
|
|
public static final int ANSWERED_ELSEWHERE = TelecomProtoEnums.ANSWERED_ELSEWHERE; // = 11
|
|
|
|
/**
|
|
* Disconnected because the call was pulled from the current device to another device.
|
|
*/
|
|
public static final int CALL_PULLED = TelecomProtoEnums.CALL_PULLED; // = 12
|
|
|
|
/**
|
|
* Reason code (returned via {@link #getReason()}) which indicates that a call could not be
|
|
* completed because the cellular radio is off or out of service, the device is connected to
|
|
* a wifi network, but the user has not enabled wifi calling.
|
|
*/
|
|
public static final String REASON_WIFI_ON_BUT_WFC_OFF = "REASON_WIFI_ON_BUT_WFC_OFF";
|
|
|
|
/**
|
|
* Reason code (returned via {@link #getReason()}), which indicates that the video telephony
|
|
* call was disconnected because IMS access is blocked.
|
|
*/
|
|
public static final String REASON_IMS_ACCESS_BLOCKED = "REASON_IMS_ACCESS_BLOCKED";
|
|
|
|
/**
|
|
* Reason code (returned via {@link #getReason()}), which indicates that the connection service
|
|
* is setting the call's state to {@link Call#STATE_DISCONNECTED} because it is internally
|
|
* changing the representation of an IMS conference call to simulate a single-party call.
|
|
*
|
|
* This reason code is only used for communication between a {@link ConnectionService} and
|
|
* Telecom and should not be surfaced to the user.
|
|
*/
|
|
public static final String REASON_EMULATING_SINGLE_CALL = "EMULATING_SINGLE_CALL";
|
|
|
|
/**
|
|
* This reason is set when a call is ended in order to place an emergency call when a
|
|
* {@link PhoneAccount} doesn't support holding an ongoing call to place an emergency call. This
|
|
* reason string should only be associated with the {@link #LOCAL} disconnect code returned from
|
|
* {@link #getCode()}.
|
|
*/
|
|
public static final String REASON_EMERGENCY_CALL_PLACED = "REASON_EMERGENCY_CALL_PLACED";
|
|
|
|
private int mDisconnectCode;
|
|
private CharSequence mDisconnectLabel;
|
|
private CharSequence mDisconnectDescription;
|
|
private String mDisconnectReason;
|
|
private int mToneToPlay;
|
|
private int mTelephonyDisconnectCause;
|
|
private int mTelephonyPreciseDisconnectCause;
|
|
private ImsReasonInfo mImsReasonInfo;
|
|
|
|
/**
|
|
* Creates a new DisconnectCause.
|
|
*
|
|
* @param code The code for the disconnect cause.
|
|
*/
|
|
public DisconnectCause(int code) {
|
|
this(code, null, null, null, ToneGenerator.TONE_UNKNOWN);
|
|
}
|
|
|
|
/**
|
|
* Creates a new DisconnectCause.
|
|
*
|
|
* @param code The code for the disconnect cause.
|
|
* @param reason The reason for the disconnect.
|
|
*/
|
|
public DisconnectCause(int code, String reason) {
|
|
this(code, null, null, reason, ToneGenerator.TONE_UNKNOWN);
|
|
}
|
|
|
|
/**
|
|
* Creates a new DisconnectCause.
|
|
*
|
|
* @param code The code for the disconnect cause.
|
|
* @param label The localized label to show to the user to explain the disconnect.
|
|
* @param description The localized description to show to the user to explain the disconnect.
|
|
* @param reason The reason for the disconnect.
|
|
*/
|
|
public DisconnectCause(int code, CharSequence label, CharSequence description, String reason) {
|
|
this(code, label, description, reason, ToneGenerator.TONE_UNKNOWN);
|
|
}
|
|
|
|
/**
|
|
* Creates a new DisconnectCause.
|
|
*
|
|
* @param code The code for the disconnect cause.
|
|
* @param label The localized label to show to the user to explain the disconnect.
|
|
* @param description The localized description to show to the user to explain the disconnect.
|
|
* @param reason The reason for the disconnect.
|
|
* @param toneToPlay The tone to play on disconnect, as defined in {@link ToneGenerator}.
|
|
*/
|
|
public DisconnectCause(int code, CharSequence label, CharSequence description, String reason,
|
|
int toneToPlay) {
|
|
this(code, label, description, reason, toneToPlay,
|
|
android.telephony.DisconnectCause.ERROR_UNSPECIFIED,
|
|
PreciseDisconnectCause.ERROR_UNSPECIFIED,
|
|
null /* imsReasonInfo */);
|
|
}
|
|
|
|
/**
|
|
* Creates a new DisconnectCause instance.
|
|
* @param code The code for the disconnect cause.
|
|
* @param label The localized label to show to the user to explain the disconnect.
|
|
* @param description The localized description to show to the user to explain the disconnect.
|
|
* @param reason The reason for the disconnect.
|
|
* @param toneToPlay The tone to play on disconnect, as defined in {@link ToneGenerator}.
|
|
* @param telephonyDisconnectCause The Telephony disconnect cause.
|
|
* @param telephonyPreciseDisconnectCause The Telephony precise disconnect cause.
|
|
* @param imsReasonInfo The relevant {@link ImsReasonInfo}, or {@code null} if not available.
|
|
* @hide
|
|
*/
|
|
public DisconnectCause(int code, CharSequence label, CharSequence description, String reason,
|
|
int toneToPlay, @Annotation.DisconnectCauses int telephonyDisconnectCause,
|
|
@Annotation.PreciseDisconnectCauses int telephonyPreciseDisconnectCause,
|
|
@Nullable ImsReasonInfo imsReasonInfo) {
|
|
mDisconnectCode = code;
|
|
mDisconnectLabel = label;
|
|
mDisconnectDescription = description;
|
|
mDisconnectReason = reason;
|
|
mToneToPlay = toneToPlay;
|
|
mTelephonyDisconnectCause = telephonyDisconnectCause;
|
|
mTelephonyPreciseDisconnectCause = telephonyPreciseDisconnectCause;
|
|
mImsReasonInfo = imsReasonInfo;
|
|
}
|
|
|
|
/**
|
|
* Returns the code for the reason for this disconnect.
|
|
*
|
|
* @return The disconnect code.
|
|
*/
|
|
public int getCode() {
|
|
return mDisconnectCode;
|
|
}
|
|
|
|
/**
|
|
* Returns a short label which explains the reason for the disconnect cause and is for display
|
|
* in the user interface. If not null, it is expected that the In-Call UI should display this
|
|
* text where it would normally display the call state ("Dialing", "Disconnected") and is
|
|
* therefore expected to be relatively small. The {@link ConnectionService } is responsible for
|
|
* providing and localizing this label. If there is no string provided, returns null.
|
|
*
|
|
* @return The disconnect label.
|
|
*/
|
|
public CharSequence getLabel() {
|
|
return mDisconnectLabel;
|
|
}
|
|
|
|
/**
|
|
* Returns a description which explains the reason for the disconnect cause and is for display
|
|
* in the user interface. This optional text is generally a longer and more descriptive version
|
|
* of {@link #getLabel}, however it can exist even if {@link #getLabel} is empty. The In-Call UI
|
|
* should display this relatively prominently; the traditional implementation displays this as
|
|
* an alert dialog. The {@link ConnectionService} is responsible for providing and localizing
|
|
* this message. If there is no string provided, returns null.
|
|
*
|
|
* @return The disconnect description.
|
|
*/
|
|
public CharSequence getDescription() {
|
|
return mDisconnectDescription;
|
|
}
|
|
|
|
/**
|
|
* Returns an explanation of the reason for the disconnect. This is not intended for display to
|
|
* the user and is used mainly for logging.
|
|
*
|
|
* @return The disconnect reason.
|
|
*/
|
|
public String getReason() {
|
|
return mDisconnectReason;
|
|
}
|
|
|
|
/**
|
|
* Returns the telephony {@link android.telephony.DisconnectCause} for the call.
|
|
* @return The disconnect cause.
|
|
* @hide
|
|
*/
|
|
public @Annotation.DisconnectCauses int getTelephonyDisconnectCause() {
|
|
return mTelephonyDisconnectCause;
|
|
}
|
|
|
|
/**
|
|
* Returns the telephony {@link android.telephony.PreciseDisconnectCause} for the call.
|
|
* @return The precise disconnect cause.
|
|
* @hide
|
|
*/
|
|
public @Annotation.PreciseDisconnectCauses int getTelephonyPreciseDisconnectCause() {
|
|
return mTelephonyPreciseDisconnectCause;
|
|
}
|
|
|
|
/**
|
|
* Returns the telephony {@link ImsReasonInfo} associated with the call disconnection.
|
|
* @return The {@link ImsReasonInfo} or {@code null} if not known.
|
|
* @hide
|
|
*/
|
|
public @Nullable ImsReasonInfo getImsReasonInfo() {
|
|
return mImsReasonInfo;
|
|
}
|
|
|
|
/**
|
|
* Returns the tone to play when disconnected.
|
|
*
|
|
* @return the tone as defined in {@link ToneGenerator} to play when disconnected.
|
|
*/
|
|
public int getTone() {
|
|
return mToneToPlay;
|
|
}
|
|
|
|
public static final @android.annotation.NonNull Creator<DisconnectCause> CREATOR
|
|
= new Creator<DisconnectCause>() {
|
|
@Override
|
|
public DisconnectCause createFromParcel(Parcel source) {
|
|
int code = source.readInt();
|
|
CharSequence label = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(source);
|
|
CharSequence description = TextUtils.CHAR_SEQUENCE_CREATOR.createFromParcel(source);
|
|
String reason = source.readString();
|
|
int tone = source.readInt();
|
|
int telephonyDisconnectCause = source.readInt();
|
|
int telephonyPreciseDisconnectCause = source.readInt();
|
|
ImsReasonInfo imsReasonInfo = source.readParcelable(null);
|
|
return new DisconnectCause(code, label, description, reason, tone,
|
|
telephonyDisconnectCause, telephonyPreciseDisconnectCause, imsReasonInfo);
|
|
}
|
|
|
|
@Override
|
|
public DisconnectCause[] newArray(int size) {
|
|
return new DisconnectCause[size];
|
|
}
|
|
};
|
|
|
|
@Override
|
|
public void writeToParcel(Parcel destination, int flags) {
|
|
destination.writeInt(mDisconnectCode);
|
|
TextUtils.writeToParcel(mDisconnectLabel, destination, flags);
|
|
TextUtils.writeToParcel(mDisconnectDescription, destination, flags);
|
|
destination.writeString(mDisconnectReason);
|
|
destination.writeInt(mToneToPlay);
|
|
destination.writeInt(mTelephonyDisconnectCause);
|
|
destination.writeInt(mTelephonyPreciseDisconnectCause);
|
|
destination.writeParcelable(mImsReasonInfo, 0);
|
|
}
|
|
|
|
@Override
|
|
public int describeContents() {
|
|
return 0;
|
|
}
|
|
|
|
@Override
|
|
public int hashCode() {
|
|
return Objects.hashCode(mDisconnectCode)
|
|
+ Objects.hashCode(mDisconnectLabel)
|
|
+ Objects.hashCode(mDisconnectDescription)
|
|
+ Objects.hashCode(mDisconnectReason)
|
|
+ Objects.hashCode(mToneToPlay)
|
|
+ Objects.hashCode(mTelephonyDisconnectCause)
|
|
+ Objects.hashCode(mTelephonyPreciseDisconnectCause)
|
|
+ Objects.hashCode(mImsReasonInfo);
|
|
}
|
|
|
|
@Override
|
|
public boolean equals(Object o) {
|
|
if (o instanceof DisconnectCause) {
|
|
DisconnectCause d = (DisconnectCause) o;
|
|
return Objects.equals(mDisconnectCode, d.getCode())
|
|
&& Objects.equals(mDisconnectLabel, d.getLabel())
|
|
&& Objects.equals(mDisconnectDescription, d.getDescription())
|
|
&& Objects.equals(mDisconnectReason, d.getReason())
|
|
&& Objects.equals(mToneToPlay, d.getTone())
|
|
&& Objects.equals(mTelephonyDisconnectCause, d.getTelephonyDisconnectCause())
|
|
&& Objects.equals(mTelephonyPreciseDisconnectCause,
|
|
d.getTelephonyPreciseDisconnectCause())
|
|
&& Objects.equals(mImsReasonInfo, d.getImsReasonInfo());
|
|
}
|
|
return false;
|
|
}
|
|
|
|
@Override
|
|
public String toString() {
|
|
String code = "";
|
|
switch (mDisconnectCode) {
|
|
case UNKNOWN:
|
|
code = "UNKNOWN";
|
|
break;
|
|
case ERROR:
|
|
code = "ERROR";
|
|
break;
|
|
case LOCAL:
|
|
code = "LOCAL";
|
|
break;
|
|
case REMOTE:
|
|
code = "REMOTE";
|
|
break;
|
|
case CANCELED:
|
|
code = "CANCELED";
|
|
break;
|
|
case MISSED:
|
|
code = "MISSED";
|
|
break;
|
|
case REJECTED:
|
|
code = "REJECTED";
|
|
break;
|
|
case BUSY:
|
|
code = "BUSY";
|
|
break;
|
|
case RESTRICTED:
|
|
code = "RESTRICTED";
|
|
break;
|
|
case OTHER:
|
|
code = "OTHER";
|
|
break;
|
|
case CONNECTION_MANAGER_NOT_SUPPORTED:
|
|
code = "CONNECTION_MANAGER_NOT_SUPPORTED";
|
|
break;
|
|
case CALL_PULLED:
|
|
code = "CALL_PULLED";
|
|
break;
|
|
case ANSWERED_ELSEWHERE:
|
|
code = "ANSWERED_ELSEWHERE";
|
|
break;
|
|
default:
|
|
code = "invalid code: " + mDisconnectCode;
|
|
break;
|
|
}
|
|
String label = mDisconnectLabel == null ? "" : mDisconnectLabel.toString();
|
|
String description = mDisconnectDescription == null
|
|
? "" : mDisconnectDescription.toString();
|
|
String reason = mDisconnectReason == null ? "" : mDisconnectReason;
|
|
return "DisconnectCause [ Code: (" + code + ")"
|
|
+ " Label: (" + label + ")"
|
|
+ " Description: (" + description + ")"
|
|
+ " Reason: (" + reason + ")"
|
|
+ " Tone: (" + mToneToPlay + ") "
|
|
+ " TelephonyCause: " + mTelephonyDisconnectCause + "/"
|
|
+ mTelephonyPreciseDisconnectCause
|
|
+ " ImsReasonInfo: "
|
|
+ mImsReasonInfo
|
|
+ "]";
|
|
}
|
|
}
|