script-astra/Android/Sdk/sources/android-35/android/telephony/CallQuality.java

/*
 * 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.
 */

package android.telephony;

import android.annotation.IntDef;
import android.annotation.NonNull;
import android.annotation.Nullable;
import android.annotation.SystemApi;
import android.os.Parcel;
import android.os.Parcelable;

import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.util.Objects;

/**
 * Parcelable object to handle call quality.
 * <p>
 * Currently this supports IMS calls.
 * <p>
 * It provides the call quality level, duration, and additional information related to RTP packets,
 * jitter and delay.
 * <p>
 * If there are multiple active calls, the CallQuality will pertain to the call in the foreground.
 *
 * @hide
 */
@SystemApi
public final class CallQuality implements Parcelable {

    // Constants representing the call quality level (see #CallQuality);
    public static final int CALL_QUALITY_EXCELLENT = 0;
    public static final int CALL_QUALITY_GOOD = 1;
    public static final int CALL_QUALITY_FAIR = 2;
    public static final int CALL_QUALITY_POOR = 3;
    public static final int CALL_QUALITY_BAD = 4;
    public static final int CALL_QUALITY_NOT_AVAILABLE = 5;

    /**
     * Call quality
     * @hide
     */
    @IntDef(prefix = { "CALL_QUALITY_" }, value = {
            CALL_QUALITY_EXCELLENT,
            CALL_QUALITY_GOOD,
            CALL_QUALITY_FAIR,
            CALL_QUALITY_POOR,
            CALL_QUALITY_BAD,
            CALL_QUALITY_NOT_AVAILABLE,
    })
    @Retention(RetentionPolicy.SOURCE)
    public @interface CallQualityLevel {}

    @CallQualityLevel
    private int mDownlinkCallQualityLevel;
    @CallQualityLevel
    private int mUplinkCallQualityLevel;
    private int mCallDuration;
    private int mNumRtpPacketsTransmitted;
    private int mNumRtpPacketsReceived;
    private int mNumRtpPacketsTransmittedLost;
    private int mNumRtpPacketsNotReceived;
    private int mAverageRelativeJitter;
    private int mMaxRelativeJitter;
    private int mAverageRoundTripTime;
    private int mCodecType;
    private boolean mRtpInactivityDetected;
    private boolean mRxSilenceDetected;
    private boolean mTxSilenceDetected;
    private int mNumVoiceFrames;
    private int mNumNoDataFrames;
    private int mNumDroppedRtpPackets;
    private long mMinPlayoutDelayMillis;
    private long mMaxPlayoutDelayMillis;
    private int mNumRtpSidPacketsReceived;
    private int mNumRtpDuplicatePackets;

    /** @hide **/
    public CallQuality(Parcel in) {
        mDownlinkCallQualityLevel = in.readInt();
        mUplinkCallQualityLevel = in.readInt();
        mCallDuration = in.readInt();
        mNumRtpPacketsTransmitted = in.readInt();
        mNumRtpPacketsReceived = in.readInt();
        mNumRtpPacketsTransmittedLost = in.readInt();
        mNumRtpPacketsNotReceived = in.readInt();
        mAverageRelativeJitter = in.readInt();
        mMaxRelativeJitter = in.readInt();
        mAverageRoundTripTime = in.readInt();
        mCodecType = in.readInt();
        mRtpInactivityDetected = in.readBoolean();
        mRxSilenceDetected = in.readBoolean();
        mTxSilenceDetected = in.readBoolean();
        mNumVoiceFrames = in.readInt();
        mNumNoDataFrames = in.readInt();
        mNumDroppedRtpPackets = in.readInt();
        mMinPlayoutDelayMillis = in.readLong();
        mMaxPlayoutDelayMillis = in.readLong();
        mNumRtpSidPacketsReceived = in.readInt();
        mNumRtpDuplicatePackets = in.readInt();
    }

    /** @hide **/
    public CallQuality() {
    }

    /**
     * Constructor.
     *
     * @param callQualityLevel the call quality level (see #CallQualityLevel)
     * @param callDuration the call duration in milliseconds
     * @param numRtpPacketsTransmitted RTP packets sent to network
     * @param numRtpPacketsReceived RTP packets received from network
     * @param numRtpPacketsTransmittedLost RTP packets which were lost in network and never
     * transmitted
     * @param numRtpPacketsNotReceived RTP packets which were lost in network and never received
     * @param averageRelativeJitter average relative jitter in milliseconds
     * @param maxRelativeJitter maximum relative jitter in milliseconds
     * @param averageRoundTripTime average round trip delay in milliseconds
     * @param codecType the codec type
     */
    public CallQuality(
            @CallQualityLevel int downlinkCallQualityLevel,
            @CallQualityLevel int uplinkCallQualityLevel,
            int callDuration,
            int numRtpPacketsTransmitted,
            int numRtpPacketsReceived,
            int numRtpPacketsTransmittedLost,
            int numRtpPacketsNotReceived,
            int averageRelativeJitter,
            int maxRelativeJitter,
            int averageRoundTripTime,
            int codecType) {
        this(downlinkCallQualityLevel, uplinkCallQualityLevel, callDuration,
            numRtpPacketsTransmitted, numRtpPacketsReceived, numRtpPacketsTransmittedLost,
            numRtpPacketsNotReceived, averageRelativeJitter, maxRelativeJitter,
            averageRoundTripTime, codecType, false, false, false);
    }

    /**
     * Constructor.
     *
     * @param callQualityLevel the call quality level (see #CallQualityLevel)
     * @param callDuration the call duration in milliseconds
     * @param numRtpPacketsTransmitted RTP packets sent to network
     * @param numRtpPacketsReceived RTP packets received from network
     * @param numRtpPacketsTransmittedLost RTP packets which were lost in network and never
     * transmitted
     * @param numRtpPacketsNotReceived RTP packets which were lost in network and never received
     * @param averageRelativeJitter average relative jitter in milliseconds
     * @param maxRelativeJitter maximum relative jitter in milliseconds
     * @param averageRoundTripTime average round trip delay in milliseconds
     * @param codecType the codec type
     * @param rtpInactivityDetected True if no incoming RTP is received for a continuous duration of
     * 4 seconds
     * @param rxSilenceDetected True if only silence RTP packets are received for 20 seconds
     * immediately after call is connected
     * @param txSilenceDetected True if only silence RTP packets are sent for 20 seconds immediately
     * after call is connected
     */
    public CallQuality(
            @CallQualityLevel int downlinkCallQualityLevel,
            @CallQualityLevel int uplinkCallQualityLevel,
            int callDuration,
            int numRtpPacketsTransmitted,
            int numRtpPacketsReceived,
            int numRtpPacketsTransmittedLost,
            int numRtpPacketsNotReceived,
            int averageRelativeJitter,
            int maxRelativeJitter,
            int averageRoundTripTime,
            int codecType,
            boolean rtpInactivityDetected,
            boolean rxSilenceDetected,
            boolean txSilenceDetected) {
        this.mDownlinkCallQualityLevel = downlinkCallQualityLevel;
        this.mUplinkCallQualityLevel = uplinkCallQualityLevel;
        this.mCallDuration = callDuration;
        this.mNumRtpPacketsTransmitted = numRtpPacketsTransmitted;
        this.mNumRtpPacketsReceived = numRtpPacketsReceived;
        this.mNumRtpPacketsTransmittedLost = numRtpPacketsTransmittedLost;
        this.mNumRtpPacketsNotReceived = numRtpPacketsNotReceived;
        this.mAverageRelativeJitter = averageRelativeJitter;
        this.mMaxRelativeJitter = maxRelativeJitter;
        this.mAverageRoundTripTime = averageRoundTripTime;
        this.mCodecType = codecType;
        this.mRtpInactivityDetected = rtpInactivityDetected;
        this.mRxSilenceDetected = rxSilenceDetected;
        this.mTxSilenceDetected = txSilenceDetected;
    }

    // getters
    /**
     * Returns the downlink CallQualityLevel for a given ongoing call.
     */
    @CallQualityLevel
    public int getDownlinkCallQualityLevel() {
        return mDownlinkCallQualityLevel;
    }

    /**
     * Returns the uplink CallQualityLevel for a given ongoing call.
     */
    @CallQualityLevel
    public int getUplinkCallQualityLevel() {
        return mUplinkCallQualityLevel;
    }

    /**
     * Returns the duration of the call, in milliseconds.
     */
    public int getCallDuration() {
        return mCallDuration;
    }

    /**
     * Returns the total number of RTP packets transmitted by this device for a given ongoing call.
     */
    public int getNumRtpPacketsTransmitted() {
        return mNumRtpPacketsTransmitted;
    }

    /**
     * Returns the total number of RTP packets received by this device for a given ongoing call.
     */
    public int getNumRtpPacketsReceived() {
        return mNumRtpPacketsReceived;
    }

    /**
     * Returns the number of RTP packets which were sent by this device but were lost in the
     * network before reaching the other party.
     */
    public int getNumRtpPacketsTransmittedLost() {
        return mNumRtpPacketsTransmittedLost;
    }

    /**
     * Returns the number of RTP packets which were sent by the other party but were lost in the
     * network before reaching this device.
     */
    public int getNumRtpPacketsNotReceived() {
        return mNumRtpPacketsNotReceived;
    }

    /**
     * Returns the average relative jitter in milliseconds. Jitter represents the amount of variance
     * in interarrival time of packets, for example, if two packets are sent 2 milliseconds apart
     * but received 3 milliseconds apart, the relative jitter between those packets is 1
     * millisecond.
     *
     * <p>See RFC 3550 for more information on jitter calculations.
     */
    public int getAverageRelativeJitter() {
        return mAverageRelativeJitter;
    }

    /**
     * Returns the maximum relative jitter for a given ongoing call. Jitter represents the amount of
     * variance in interarrival time of packets, for example, if two packets are sent 2 milliseconds
     * apart but received 3 milliseconds apart, the relative jitter between those packets is 1
     * millisecond.
     *
     * <p>See RFC 3550 for more information on jitter calculations.
     */
    public int getMaxRelativeJitter() {
        return mMaxRelativeJitter;
    }

    /**
     * Returns the average round trip time in milliseconds.
     */
    public int getAverageRoundTripTime() {
        return mAverageRoundTripTime;
    }

    /**
     * Returns true if no rtp packets are received continuously for the last 4 seconds
     */
    public boolean isRtpInactivityDetected() {
        return mRtpInactivityDetected;
    }

    /**
     * Returns true if only silence rtp packets are received for a duration of 20 seconds starting
     * at call setup
     */
    public boolean isIncomingSilenceDetectedAtCallSetup() {
        return mRxSilenceDetected;
    }

    /**
      * Returns true if only silence rtp packets are sent for a duration of 20 seconds starting at
      * call setup
      */
    public boolean isOutgoingSilenceDetectedAtCallSetup() {
        return mTxSilenceDetected;
    }

    /**
     * Returns the number of Voice frames sent by jitter buffer to audio
     */
    public int getNumVoiceFrames() {
        return mNumVoiceFrames;
    }

    /**
     * Returns the number of no-data frames sent by jitter buffer to audio
     */
    public int getNumNoDataFrames() {
        return mNumNoDataFrames;
    }

    /**
     * Returns the number of RTP voice packets dropped by jitter buffer
     */
    public int getNumDroppedRtpPackets() {
        return mNumDroppedRtpPackets;
    }

    /**
     * Returns the minimum playout delay in the reporting interval
     * in milliseconds.
     */
    public long getMinPlayoutDelayMillis() {
        return mMinPlayoutDelayMillis;
    }

    /**
     * Returns the maximum playout delay in the reporting interval
     * in milliseconds.
     */
    public long getMaxPlayoutDelayMillis() {
        return mMaxPlayoutDelayMillis;
    }

    /**
     * Returns the total number of RTP SID (Silence Insertion Descriptor) packets
     * received by this device for an ongoing call
     */
    public int getNumRtpSidPacketsReceived() {
        return mNumRtpSidPacketsReceived;
    }

    /**
     * Returns the total number of RTP duplicate packets received by this device
     * for an ongoing call
     */
    public int getNumRtpDuplicatePackets() {
        return mNumRtpDuplicatePackets;
    }

    /**
     * Returns the codec type. This value corresponds to the AUDIO_QUALITY_* constants in
     * {@link ImsStreamMediaProfile}.
     *
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_NONE
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_AMR
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_AMR_WB
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_QCELP13K
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVRC
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVRC_B
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVRC_WB
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVRC_NW
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_GSM_EFR
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_GSM_FR
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_GSM_HR
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_G711U
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_G723
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_G711A
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_G722
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_G711AB
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_G729
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVS_NB
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVS_WB
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVS_SWB
     * @see ImsStreamMediaProfile#AUDIO_QUALITY_EVS_FB
     */
    public int getCodecType() {
        return mCodecType;
    }

    // Parcelable things
    @NonNull
    @Override
    public String toString() {
        return "CallQuality: {downlinkCallQualityLevel=" + mDownlinkCallQualityLevel
                + " uplinkCallQualityLevel=" + mUplinkCallQualityLevel
                + " callDuration=" + mCallDuration
                + " numRtpPacketsTransmitted=" + mNumRtpPacketsTransmitted
                + " numRtpPacketsReceived=" + mNumRtpPacketsReceived
                + " numRtpPacketsTransmittedLost=" + mNumRtpPacketsTransmittedLost
                + " numRtpPacketsNotReceived=" + mNumRtpPacketsNotReceived
                + " averageRelativeJitter=" + mAverageRelativeJitter
                + " maxRelativeJitter=" + mMaxRelativeJitter
                + " averageRoundTripTime=" + mAverageRoundTripTime
                + " codecType=" + mCodecType
                + " rtpInactivityDetected=" + mRtpInactivityDetected
                + " txSilenceDetected=" + mTxSilenceDetected
                + " rxSilenceDetected=" + mRxSilenceDetected
                + " numVoiceFrames=" + mNumVoiceFrames
                + " numNoDataFrames=" + mNumNoDataFrames
                + " numDroppedRtpPackets=" + mNumDroppedRtpPackets
                + " minPlayoutDelayMillis=" + mMinPlayoutDelayMillis
                + " maxPlayoutDelayMillis=" + mMaxPlayoutDelayMillis
                + " numRtpSidPacketsReceived=" + mNumRtpSidPacketsReceived
                + " numRtpDuplicatePackets=" + mNumRtpDuplicatePackets
                + "}";
    }

    @Override
    public int hashCode() {
        return Objects.hash(
                mDownlinkCallQualityLevel,
                mUplinkCallQualityLevel,
                mCallDuration,
                mNumRtpPacketsTransmitted,
                mNumRtpPacketsReceived,
                mNumRtpPacketsTransmittedLost,
                mNumRtpPacketsNotReceived,
                mAverageRelativeJitter,
                mMaxRelativeJitter,
                mAverageRoundTripTime,
                mCodecType,
                mRtpInactivityDetected,
                mRxSilenceDetected,
                mTxSilenceDetected,
                mNumVoiceFrames,
                mNumNoDataFrames,
                mNumDroppedRtpPackets,
                mMinPlayoutDelayMillis,
                mMaxPlayoutDelayMillis,
                mNumRtpSidPacketsReceived,
                mNumRtpDuplicatePackets);
    }

    @Override
    public boolean equals(@Nullable Object o) {
        if (o == null || !(o instanceof CallQuality) || hashCode() != o.hashCode()) {
            return false;
        }

        if (this == o) {
            return true;
        }

        CallQuality s = (CallQuality) o;

        return (mDownlinkCallQualityLevel == s.mDownlinkCallQualityLevel
                && mUplinkCallQualityLevel == s.mUplinkCallQualityLevel
                && mCallDuration == s.mCallDuration
                && mNumRtpPacketsTransmitted == s.mNumRtpPacketsTransmitted
                && mNumRtpPacketsReceived == s.mNumRtpPacketsReceived
                && mNumRtpPacketsTransmittedLost == s.mNumRtpPacketsTransmittedLost
                && mNumRtpPacketsNotReceived == s.mNumRtpPacketsNotReceived
                && mAverageRelativeJitter == s.mAverageRelativeJitter
                && mMaxRelativeJitter == s.mMaxRelativeJitter
                && mAverageRoundTripTime == s.mAverageRoundTripTime
                && mCodecType == s.mCodecType
                && mRtpInactivityDetected == s.mRtpInactivityDetected
                && mRxSilenceDetected == s.mRxSilenceDetected
                && mTxSilenceDetected == s.mTxSilenceDetected
                && mNumVoiceFrames == s.mNumVoiceFrames
                && mNumNoDataFrames == s.mNumNoDataFrames
                && mNumDroppedRtpPackets == s.mNumDroppedRtpPackets
                && mMinPlayoutDelayMillis == s.mMinPlayoutDelayMillis
                && mMaxPlayoutDelayMillis == s.mMaxPlayoutDelayMillis
                && mNumRtpSidPacketsReceived == s.mNumRtpSidPacketsReceived
                && mNumRtpDuplicatePackets == s.mNumRtpDuplicatePackets);
    }

    /**
     * {@link Parcelable#describeContents}
     */
    public int describeContents() {
        return 0;
    }

    /**
     * {@link Parcelable#writeToParcel}
     */
    public void writeToParcel(Parcel dest, int flags) {
        dest.writeInt(mDownlinkCallQualityLevel);
        dest.writeInt(mUplinkCallQualityLevel);
        dest.writeInt(mCallDuration);
        dest.writeInt(mNumRtpPacketsTransmitted);
        dest.writeInt(mNumRtpPacketsReceived);
        dest.writeInt(mNumRtpPacketsTransmittedLost);
        dest.writeInt(mNumRtpPacketsNotReceived);
        dest.writeInt(mAverageRelativeJitter);
        dest.writeInt(mMaxRelativeJitter);
        dest.writeInt(mAverageRoundTripTime);
        dest.writeInt(mCodecType);
        dest.writeBoolean(mRtpInactivityDetected);
        dest.writeBoolean(mRxSilenceDetected);
        dest.writeBoolean(mTxSilenceDetected);
        dest.writeInt(mNumVoiceFrames);
        dest.writeInt(mNumNoDataFrames);
        dest.writeInt(mNumDroppedRtpPackets);
        dest.writeLong(mMinPlayoutDelayMillis);
        dest.writeLong(mMaxPlayoutDelayMillis);
        dest.writeInt(mNumRtpSidPacketsReceived);
        dest.writeInt(mNumRtpDuplicatePackets);
    }

    public static final @android.annotation.NonNull Parcelable.Creator<CallQuality> CREATOR = new Parcelable.Creator() {
        public CallQuality createFromParcel(Parcel in) {
            return new CallQuality(in);
        }

        public CallQuality[] newArray(int size) {
            return new CallQuality[size];
        }
    };

    /**
     * Provides a convenient way to set the fields of a {@link CallQuality} when creating a new
     * instance.
     *
     * <p>The example below shows how you might create a new {@code CallQuality}:
     *
     * <pre><code>
     *
     * CallQuality callQuality = new CallQuality.Builder()
     *     .setNumRtpPacketsTransmitted(150)
     *     .setNumRtpPacketsReceived(200)
     *     .build();
     * </code></pre>
     */
    public static final class Builder {

        private int mDownlinkCallQualityLevel;
        private int mUplinkCallQualityLevel;
        private int mCallDuration;
        private int mNumRtpPacketsTransmitted;
        private int mNumRtpPacketsReceived;
        private int mNumRtpPacketsTransmittedLost;
        private int mNumRtpPacketsNotReceived;
        private int mAverageRelativeJitter;
        private int mMaxRelativeJitter;
        private int mAverageRoundTripTime;
        private int mCodecType;
        private boolean mRtpInactivityDetected;
        private boolean mRxSilenceDetected;
        private boolean mTxSilenceDetected;
        private int mNumVoiceFrames;
        private int mNumNoDataFrames;
        private int mNumDroppedRtpPackets;
        private long mMinPlayoutDelayMillis;
        private long mMaxPlayoutDelayMillis;
        private int mNumRtpSidPacketsReceived;
        private int mNumRtpDuplicatePackets;

        /**
         * Set the downlink call quality level for ongoing call.
         *
         * @param downlinkCallQualityLevel the Downlink call quality level
         * @return The same instance of the builder.
         */
        public @NonNull Builder setDownlinkCallQualityLevel(
                @CallQualityLevel int downlinkCallQualityLevel) {
            mDownlinkCallQualityLevel = downlinkCallQualityLevel;
            return this;
        }

        /**
         * Set the uplink call quality level for ongoing call.
         *
         * @param uplinkCallQualityLevel the Uplink call quality level
         * @return The same instance of the builder.
         */
        public @NonNull Builder setUplinkCallQualityLevel(
                @CallQualityLevel int uplinkCallQualityLevel) {
            mUplinkCallQualityLevel = uplinkCallQualityLevel;
            return this;
        }

        /**
         * Set the call duration in milliseconds.
         *
         * @param callDuration the call duration in milliseconds
         * @return The same instance of the builder.
         */
        // Newer builder includes guidelines compliant units; existing method does not.
        @NonNull
        @SuppressWarnings("MissingGetterMatchingBuilder")
        public Builder setCallDurationMillis(int callDurationMillis) {
            mCallDuration = callDurationMillis;
            return this;
        }

        /**
         * Set the number of RTP packets sent for ongoing call.
         *
         * @param numRtpPacketsTransmitted RTP packets sent to network
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumRtpPacketsTransmitted(int numRtpPacketsTransmitted) {
            mNumRtpPacketsTransmitted = numRtpPacketsTransmitted;
            return this;
        }

        /**
         * Set the number of RTP packets received for ongoing call.
         *
         * @param numRtpPacketsReceived RTP packets received from network
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumRtpPacketsReceived(int numRtpPacketsReceived) {
            mNumRtpPacketsReceived = numRtpPacketsReceived;
            return this;
        }

        /**
         * Set the number of RTP packets which were lost in network and never
         * transmitted.
         *
         * @param numRtpPacketsTransmittedLost RTP packets which were lost in network and never
         * transmitted
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumRtpPacketsTransmittedLost(int numRtpPacketsTransmittedLost) {
            mNumRtpPacketsTransmittedLost = numRtpPacketsTransmittedLost;
            return this;
        }

        /**
         * Set the number of RTP packets which were lost in network and never received.
         *
         * @param numRtpPacketsNotReceived RTP packets which were lost in network and
         * never received
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumRtpPacketsNotReceived(int numRtpPacketsNotReceived) {
            mNumRtpPacketsNotReceived = numRtpPacketsNotReceived;
            return this;
        }

        /**
         * Set the average relative jitter in milliseconds.
         *
         * @param averageRelativeJitter average relative jitter in milliseconds
         * @return The same instance of the builder.
         */
        public @NonNull Builder setAverageRelativeJitter(int averageRelativeJitter) {
            mAverageRelativeJitter = averageRelativeJitter;
            return this;
        }

        /**
         * Set the maximum relative jitter in milliseconds.
         *
         * @param maxRelativeJitter maximum relative jitter in milliseconds
         * @return The same instance of the builder.
         */
        public @NonNull Builder setMaxRelativeJitter(int maxRelativeJitter) {
            mMaxRelativeJitter = maxRelativeJitter;
            return this;
        }

        /**
         * Set the average round trip delay in milliseconds.
         *
         * @param averageRoundTripTime average round trip delay in milliseconds
         * @return The same instance of the builder.
         */
        // Newer builder includes guidelines compliant units; existing method does not.
        @NonNull
        @SuppressWarnings("MissingGetterMatchingBuilder")
        public Builder setAverageRoundTripTimeMillis(int averageRoundTripTimeMillis) {
            mAverageRoundTripTime = averageRoundTripTimeMillis;
            return this;
        }

        /**
         * Set the codec type used in the ongoing call.
         *
         * @param codecType the codec type.
         * @return The same instance of the builder.
         */
        public @NonNull Builder setCodecType(int codecType) {
            mCodecType = codecType;
            return this;
        }

        /**
         * Set to be True if no incoming RTP is received for a continuous
         * duration of 4 seconds.
         *
         * @param rtpInactivityDetected True if no incoming RTP is received for
         * a continuous duration of 4 seconds
         * @return The same instance of the builder.
         */
        public @NonNull Builder setRtpInactivityDetected(boolean rtpInactivityDetected) {
            mRtpInactivityDetected = rtpInactivityDetected;
            return this;
        }

        /**
         * Set to be True if only silence RTP packets are received for 20 seconds
         * immediately after call is connected.
         *
         * @param rxSilenceDetected True if only silence RTP packets are received for 20 seconds
         * immediately after call is connected
         * @return The same instance of the builder.
         */
        public @NonNull Builder setIncomingSilenceDetectedAtCallSetup(boolean rxSilenceDetected) {
            mRxSilenceDetected = rxSilenceDetected;
            return this;
        }

        /**
         * Set to be True if only silence RTP packets are sent for 20 seconds immediately
         * after call is connected.
         *
         * @param txSilenceDetected True if only silence RTP packets are sent for
         * 20 seconds immediately after call is connected.
         * @return The same instance of the builder.
         */
        public @NonNull Builder setOutgoingSilenceDetectedAtCallSetup(boolean txSilenceDetected) {
            mTxSilenceDetected = txSilenceDetected;
            return this;
        }

        /**
         * Set the number of voice frames sent by jitter buffer to audio.
         *
         * @param numVoiceFrames Voice frames sent by jitter buffer to audio.
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumVoiceFrames(int numVoiceFrames) {
            mNumVoiceFrames = numVoiceFrames;
            return this;
        }

        /**
         * Set the number of no-data frames sent by jitter buffer to audio.
         *
         * @param numNoDataFrames no-data frames sent by jitter buffer to audio
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumNoDataFrames(int numNoDataFrames) {
            mNumNoDataFrames = numNoDataFrames;
            return this;
        }

        /**
         * Set the number of RTP Voice packets dropped by jitter buffer.
         *
         * @param numDroppedRtpPackets number of RTP Voice packets dropped by jitter buffer
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumDroppedRtpPackets(int numDroppedRtpPackets) {
            mNumDroppedRtpPackets = numDroppedRtpPackets;
            return this;
        }

        /**
         * Set the minimum playout delay in the reporting interval in milliseconds.
         *
         * @param minPlayoutDelayMillis minimum playout delay in the reporting interval
         * @return The same instance of the builder.
         */
        public @NonNull Builder setMinPlayoutDelayMillis(long minPlayoutDelayMillis) {
            mMinPlayoutDelayMillis = minPlayoutDelayMillis;
            return this;
        }

        /**
         * Set the maximum Playout delay in the reporting interval in milliseconds.
         *
         * @param maxPlayoutDelayMillis maximum Playout delay in the reporting interval
         * @return The same instance of the builder.
         */
        public @NonNull Builder setMaxPlayoutDelayMillis(long maxPlayoutDelayMillis) {
            mMaxPlayoutDelayMillis = maxPlayoutDelayMillis;
            return this;
        }

        /**
         * Set the total number of RTP SID (Silence Insertion Descriptor)
         * packets received by this device for an ongoing call.
         *
         * @param numRtpSidPacketsReceived the total number of RTP SID packets received
         * by this device for an ongoing call.
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumRtpSidPacketsReceived(int numRtpSidPacketsReceived) {
            mNumRtpSidPacketsReceived = numRtpSidPacketsReceived;
            return this;
        }

        /**
         * Set the total number of RTP duplicate packets received by this device
         * for an ongoing call.
         *
         * @param numRtpDuplicatePackets the total number of RTP duplicate packets
         * received by this device for an ongoing call
         * @return The same instance of the builder.
         */
        public @NonNull Builder setNumRtpDuplicatePackets(int numRtpDuplicatePackets) {
            mNumRtpDuplicatePackets = numRtpDuplicatePackets;
            return this;
        }

        /**
         * Build the CallQuality.
         *
         * @return the CallQuality object.
         */
        public @NonNull CallQuality build() {

            CallQuality callQuality = new CallQuality();
            callQuality.mDownlinkCallQualityLevel = mDownlinkCallQualityLevel;
            callQuality.mUplinkCallQualityLevel = mUplinkCallQualityLevel;
            callQuality.mCallDuration = mCallDuration;
            callQuality.mNumRtpPacketsTransmitted = mNumRtpPacketsTransmitted;
            callQuality.mNumRtpPacketsReceived = mNumRtpPacketsReceived;
            callQuality.mNumRtpPacketsTransmittedLost = mNumRtpPacketsTransmittedLost;
            callQuality.mNumRtpPacketsNotReceived = mNumRtpPacketsNotReceived;
            callQuality.mAverageRelativeJitter = mAverageRelativeJitter;
            callQuality.mMaxRelativeJitter = mMaxRelativeJitter;
            callQuality.mAverageRoundTripTime = mAverageRoundTripTime;
            callQuality.mCodecType = mCodecType;
            callQuality.mRtpInactivityDetected = mRtpInactivityDetected;
            callQuality.mTxSilenceDetected = mTxSilenceDetected;
            callQuality.mRxSilenceDetected = mRxSilenceDetected;
            callQuality.mNumVoiceFrames = mNumVoiceFrames;
            callQuality.mNumNoDataFrames = mNumNoDataFrames;
            callQuality.mNumDroppedRtpPackets = mNumDroppedRtpPackets;
            callQuality.mMinPlayoutDelayMillis = mMinPlayoutDelayMillis;
            callQuality.mMaxPlayoutDelayMillis = mMaxPlayoutDelayMillis;
            callQuality.mNumRtpSidPacketsReceived = mNumRtpSidPacketsReceived;
            callQuality.mNumRtpDuplicatePackets = mNumRtpDuplicatePackets;

            return callQuality;
        }
    }
}