Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c477d9c0 authored by Tej Singh's avatar Tej Singh
Browse files

Atom: CallStateChanged 

Adds CallStateChanged atom, including the state and disconnect cause
(when the state is disconnected). Makes the constants in CallState.java
(in packages/services) and DisconnectCause.java reference the proto
enum.

Test: atest TelecomUnitTests, verified events were received in adb logcat -b stats
Change-Id: I5c4d91387259fc7349e17551962cb490f5ed9f36
parent 9d7f2f40

cmds/statsd/src/atoms.proto

+29 −0
Original line number Diff line number Diff line
@@ -24,6 +24,7 @@ option java_outer_classname = "AtomsProto"; 
import "frameworks/base/core/proto/android/app/enums.proto";

import "frameworks/base/core/proto/android/os/enums.proto";

import "frameworks/base/core/proto/android/server/enums.proto";

import "frameworks/base/core/proto/android/telecomm/enums.proto";

import "frameworks/base/core/proto/android/telephony/enums.proto";

import "frameworks/base/core/proto/android/view/enums.proto";
@@ -98,6 +99,7 @@ message Atom { 
        DaveyOccurred davey_occurred = 58;

        OverlayStateChanged overlay_state_changed = 59;

        ForegroundServiceStateChanged foreground_service_state_changed = 60;

        CallStateChanged call_state_changed = 61;

        // TODO: Reorder the numbering so that the most frequent occur events occur in the first 15.

    }
@@ -725,6 +727,33 @@ message BootSequenceReported { 
    optional int64 time_since_last_boot = 6;

}





/**

 * Logs call state and disconnect cause (if applicable).

 *

 * Logged from:

 *   packages/services/Telecomm/src/com/android/server/telecom/Call.java

 */

message CallStateChanged {

    // The state of the call. Eg. DIALING, ACTIVE, ON_HOLD, DISCONNECTED.

    // From frameworks/base/core/proto/android/telecomm/enums.proto.

    optional android.telecom.CallStateEnum call_state = 1;



    // The reason the call disconnected. Eg. ERROR, MISSED, REJECTED, BUSY.

    // This value is only applicable when the call_state is DISCONNECTED, and

    // should always be UNKNOWN if the call_state is not DISCONNECTED.

    // From frameworks/base/core/proto/android/telecomm/enums.proto.

    optional android.telecom.DisconnectCauseEnum disconnect_cause = 2;



    // True if the call is self-managed, which are apps that use the

    // telecom infrastructure to make their own calls.

    optional bool self_managed = 3;



    // True if call is external. External calls are calls on connected Wear

    // devices but show up in Telecom so the user can pull them onto the device.

    optional bool external_call = 4;

}



/**

 * Logs the duration of a davey (jank of >=700ms) when it occurs

 *

core/proto/android/telecomm/enums.proto

0 → 100644
+185 −0
Original line number Diff line number Diff line 
/*

 * Copyright (C) 2018 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.

 */



syntax = "proto2";

package android.telecom;



option java_outer_classname = "TelecomProtoEnums";

option java_multiple_files = true;



/**

 * Call states, primarily used in CallState.java,

 * Call.java, and CallsManager.java in packages/services.

 */

enum CallStateEnum {

    /**

     * Indicates that a call is new and not connected. This is used as the default state internally

     * within Telecom and should not be used between Telecom and call services. Call services are

     * not expected to ever interact with NEW calls, but {@link android.telecom.InCallService}s will

     * see calls in this state.

     */

    NEW = 0;



    /**

     * The initial state of an outgoing {@code Call}.

     * Common transitions are to {@link #DIALING} state for a successful call or

     * {@link #DISCONNECTED} if it failed.

     */

    CONNECTING = 1;



    /**

     * The state of an outgoing {@code Call} when waiting on user to select a

     * {@link android.telecom.PhoneAccount} through which to place the call.

     */

    SELECT_PHONE_ACCOUNT = 2;



    /**

     * Indicates that a call is outgoing and in the dialing state. A call transitions to this state

     * once an outgoing call has begun (e.g., user presses the dial button in Dialer). Calls in this

     * state usually transition to {@link #ACTIVE} if the call was answered or {@link #DISCONNECTED}

     * if the call was disconnected somehow (e.g., failure or cancellation of the call by the user).

     */

    DIALING = 3;



    /**

     * Indicates that a call is incoming and the user still has the option of answering, rejecting,

     * or doing nothing with the call. This state is usually associated with some type of audible

     * ringtone. Normal transitions are to {@link #ACTIVE} if answered or {@link #DISCONNECTED}

     * otherwise.

     */

    RINGING = 4;



    /**

     * Indicates that a call is currently connected to another party and a communication channel is

     * open between them. The normal transition to this state is by the user answering a

     * {@link #DIALING} call or a {@link #RINGING} call being answered by the other party.

     */

    ACTIVE = 5;



    /**

     * Indicates that the call is currently on hold. In this state, the call is not terminated

     * but no communication is allowed until the call is no longer on hold. The typical transition

     * to this state is by the user putting an {@link #ACTIVE} call on hold by explicitly performing

     * an action, such as clicking the hold button.

     */

    ON_HOLD = 6;



    /**

     * Indicates that a call is currently disconnected. All states can transition to this state

     * by the call service giving notice that the connection has been severed. When the user

     * explicitly ends a call, it will not transition to this state until the call service confirms

     * the disconnection or communication was lost to the call service currently responsible for

     * this call (e.g., call service crashes).

     */

    DISCONNECTED = 7;



    /**

     * Indicates that the call was attempted (mostly in the context of outgoing, at least at the

     * time of writing) but cancelled before it was successfully connected.

     */

    ABORTED = 8;



    /**

     * Indicates that the call is in the process of being disconnected and will transition next

     * to a {@link #DISCONNECTED} state.

     * <p>

     * This state is not expected to be communicated from the Telephony layer, but will be reported

     * to the InCall UI for calls where disconnection has been initiated by the user but the

     * ConnectionService has confirmed the call as disconnected.

     */

    DISCONNECTING = 9;



    /**

     * Indicates that the call is in the process of being pulled to the local device.

     * <p>

     * This state should only be set on a call with

     * {@link android.telecom.Connection#PROPERTY_IS_EXTERNAL_CALL} and

     * {@link android.telecom.Connection#CAPABILITY_CAN_PULL_CALL}.

     */

    PULLING = 10;

}



// Disconnect causes for a call. Primarily used by android/telecom/DisconnectCause.java

enum DisconnectCauseEnum {

    /**

     * Disconnected because of an unknown or unspecified reason.

     */

    UNKNOWN = 0;



    /**

     * Disconnected because there was an error, such as a problem with the network.

     */

    ERROR = 1;



    /**

     * Disconnected because of a local user-initiated action, such as hanging up.

     */

    LOCAL = 2;



    /**

     * Disconnected because of a remote user-initiated action, such as the other party hanging up

     * up.

     */

    REMOTE = 3;



    /**

     * Disconnected because it has been canceled.

     */

    CANCELED = 4;



    /**

     * Disconnected because there was no response to an incoming call.

     */

    MISSED = 5;



    /**

     * Disconnected because the user rejected an incoming call.

     */

    REJECTED = 6;



    /**

     * Disconnected because the other party was busy.

     */

    BUSY = 7;



    /**

     * Disconnected because of a restriction on placing the call, such as dialing in airplane

     * mode.

     */

    RESTRICTED = 8;



    /**

     * Disconnected for reason not described by other disconnect codes.

     */

    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}.

     */

    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.

     */

    ANSWERED_ELSEWHERE = 11;



    /**

     * Disconnected because the call was pulled from the current device to another device.

     */

    CALL_PULLED = 12;

}

telecomm/java/android/telecom/DisconnectCause.java

+14 −13
Original line number Diff line number Diff line
@@ -33,47 +33,48 @@ import java.util.Objects; 
public final class DisconnectCause implements Parcelable {



    /** Disconnected because of an unknown or unspecified reason. */

    public static final int UNKNOWN = 0;

    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 = 1;

    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 = 2;

    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 = 3;

    public static final int REMOTE = TelecomProtoEnums.REMOTE; // = 3

    /** Disconnected because it has been canceled. */

    public static final int CANCELED = 4;

    public static final int CANCELED = TelecomProtoEnums.CANCELED; // = 4

    /** Disconnected because there was no response to an incoming call. */

    public static final int MISSED = 5;

    public static final int MISSED = TelecomProtoEnums.MISSED; // = 5

    /** Disconnected because the user rejected an incoming call. */

    public static final int REJECTED = 6;

    public static final int REJECTED = TelecomProtoEnums.REJECTED; // = 6

    /** Disconnected because the other party was busy. */

    public static final int BUSY = 7;

    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 = 8;

    public static final int RESTRICTED = TelecomProtoEnums.RESTRICTED; // = 8

    /** Disconnected for reason not described by other disconnect codes. */

    public static final int OTHER = 9;

    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 = 10;

    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 = 11;

    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 = 12;

    public static final int CALL_PULLED = TelecomProtoEnums.CALL_PULLED; // = 12



    /**

     * Reason code (returned via {@link #getReason()}) which indicates that a call could not be