Merge "Add 5 Jitter-related and 2 RTP-related parameters to call quality" (30530053) · Commits · e / os / android_frameworks_base

core/api/system-current.txt

+33 −0

Original line number	Diff line number	Diff line
		@@ -11865,11 +11865,18 @@ package android.telephony {
		method public int getCallDuration();
		method public int getCodecType();
		method public int getDownlinkCallQualityLevel();
		method public long getMaxPlayoutDelayMillis();
		method public int getMaxRelativeJitter();
		method public long getMinPlayoutDelayMillis();
		method public int getNumDroppedRtpPackets();
		method public int getNumNoDataFrames();
		method public int getNumRtpDuplicatePackets();
		method public int getNumRtpPacketsNotReceived();
		method public int getNumRtpPacketsReceived();
		method public int getNumRtpPacketsTransmitted();
		method public int getNumRtpPacketsTransmittedLost();
		method public int getNumRtpSidPacketsRx();
		method public int getNumVoiceFrames();
		method public int getUplinkCallQualityLevel();
		method public boolean isIncomingSilenceDetectedAtCallSetup();
		method public boolean isOutgoingSilenceDetectedAtCallSetup();
		@@ -11884,6 +11891,32 @@ package android.telephony {
		field @NonNull public static final android.os.Parcelable.Creator<android.telephony.CallQuality> CREATOR;
		}

		public static final class CallQuality.Builder {
		ctor public CallQuality.Builder();
		method @NonNull public android.telephony.CallQuality build();
		method @NonNull public android.telephony.CallQuality.Builder setAverageRelativeJitter(int);
		method @NonNull public android.telephony.CallQuality.Builder setAverageRoundTripTime(int);
		method @NonNull public android.telephony.CallQuality.Builder setCallDuration(int);
		method @NonNull public android.telephony.CallQuality.Builder setCodecType(int);
		method @NonNull public android.telephony.CallQuality.Builder setDownlinkCallQualityLevel(int);
		method @NonNull public android.telephony.CallQuality.Builder setIncomingSilenceDetectedAtCallSetup(boolean);
		method @NonNull public android.telephony.CallQuality.Builder setMaxPlayoutDelayMillis(long);
		method @NonNull public android.telephony.CallQuality.Builder setMaxRelativeJitter(int);
		method @NonNull public android.telephony.CallQuality.Builder setMinPlayoutDelayMillis(long);
		method @NonNull public android.telephony.CallQuality.Builder setNumDroppedRtpPackets(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumNoDataFrames(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumRtpDuplicatePackets(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumRtpPacketsNotReceived(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumRtpPacketsReceived(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumRtpPacketsTransmitted(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumRtpPacketsTransmittedLost(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumRtpSidPacketsRx(int);
		method @NonNull public android.telephony.CallQuality.Builder setNumVoiceFrames(int);
		method @NonNull public android.telephony.CallQuality.Builder setOutgoingSilenceDetectedAtCallSetup(boolean);
		method @NonNull public android.telephony.CallQuality.Builder setRtpInactivityDetected(boolean);
		method @NonNull public android.telephony.CallQuality.Builder setUplinkCallQualityLevel(int);
		}

		public class CarrierConfigManager {
		method @NonNull @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public String getDefaultCarrierServicePackageName();
		method @NonNull public static android.os.PersistableBundle getDefaultConfig();

telephony/java/android/telephony/CallQuality.java

+415 −2

Original line number	Diff line number	Diff line
		@@ -81,6 +81,13 @@ public final class CallQuality implements Parcelable {
		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 mNumRtpSidPacketsRx;
		private int mNumRtpDuplicatePackets;

		/ @hide /
		public CallQuality(Parcel in) {
		@@ -98,6 +105,13 @@ public final class CallQuality implements Parcelable {
		mRtpInactivityDetected = in.readBoolean();
		mRxSilenceDetected = in.readBoolean();
		mTxSilenceDetected = in.readBoolean();
		mNumVoiceFrames = in.readInt();
		mNumNoDataFrames = in.readInt();
		mNumDroppedRtpPackets = in.readInt();
		mMinPlayoutDelayMillis = in.readLong();
		mMaxPlayoutDelayMillis = in.readLong();
		mNumRtpSidPacketsRx = in.readInt();
		mNumRtpDuplicatePackets = in.readInt();
		}

		/ @hide /
		@@ -297,6 +311,59 @@ public final class CallQuality implements Parcelable {
		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 getNumRtpSidPacketsRx() {
		return mNumRtpSidPacketsRx;
		}

		/**
		* 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}.
		@@ -345,6 +412,13 @@ public final class CallQuality implements Parcelable {
		+ " rtpInactivityDetected=" + mRtpInactivityDetected
		+ " txSilenceDetected=" + mTxSilenceDetected
		+ " rxSilenceDetected=" + mRxSilenceDetected
		+ " numVoiceFrames=" + mNumVoiceFrames
		+ " numNoDataFrames=" + mNumNoDataFrames
		+ " numDroppedRtpPackets=" + mNumDroppedRtpPackets
		+ " minPlayoutDelayMillis=" + mMinPlayoutDelayMillis
		+ " maxPlayoutDelayMillis=" + mMaxPlayoutDelayMillis
		+ " numRtpSidPacketsRx=" + mNumRtpSidPacketsRx
		+ " numRtpDuplicatePackets=" + mNumRtpDuplicatePackets
		+ "}";
		}

		@@ -364,7 +438,14 @@ public final class CallQuality implements Parcelable {
		mCodecType,
		mRtpInactivityDetected,
		mRxSilenceDetected,
		mTxSilenceDetected);
		mTxSilenceDetected,
		mNumVoiceFrames,
		mNumNoDataFrames,
		mNumDroppedRtpPackets,
		mMinPlayoutDelayMillis,
		mMaxPlayoutDelayMillis,
		mNumRtpSidPacketsRx,
		mNumRtpDuplicatePackets);
		}

		@Override
		@@ -392,7 +473,14 @@ public final class CallQuality implements Parcelable {
		&& mCodecType == s.mCodecType
		&& mRtpInactivityDetected == s.mRtpInactivityDetected
		&& mRxSilenceDetected == s.mRxSilenceDetected
		&& mTxSilenceDetected == s.mTxSilenceDetected);
		&& mTxSilenceDetected == s.mTxSilenceDetected
		&& mNumVoiceFrames == s.mNumVoiceFrames
		&& mNumNoDataFrames == s.mNumNoDataFrames
		&& mNumDroppedRtpPackets == s.mNumDroppedRtpPackets
		&& mMinPlayoutDelayMillis == s.mMinPlayoutDelayMillis
		&& mMaxPlayoutDelayMillis == s.mMaxPlayoutDelayMillis
		&& mNumRtpSidPacketsRx == s.mNumRtpSidPacketsRx
		&& mNumRtpDuplicatePackets == s.mNumRtpDuplicatePackets);
		}

		/**
		@@ -420,6 +508,13 @@ public final class CallQuality implements Parcelable {
		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(mNumRtpSidPacketsRx);
		dest.writeInt(mNumRtpDuplicatePackets);
		}

		public static final @android.annotation.NonNull Parcelable.Creator<CallQuality> CREATOR = new Parcelable.Creator() {
		@@ -431,4 +526,322 @@ public final class CallQuality implements Parcelable {
		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 mNumRtpSidPacketsRx;
		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.
		*/
		public @NonNull Builder setCallDuration(int callDuration) {
		mCallDuration = callDuration;
		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.
		*/
		public @NonNull Builder setAverageRoundTripTime(int averageRoundTripTime) {
		mAverageRoundTripTime = averageRoundTripTime;
		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 numRtpSidPacketsRx 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 setNumRtpSidPacketsRx(int numRtpSidPacketsRx) {
		mNumRtpSidPacketsRx = numRtpSidPacketsRx;
		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.mNumRtpSidPacketsRx = mNumRtpSidPacketsRx;
		callQuality.mNumRtpDuplicatePackets = mNumRtpDuplicatePackets;

		return callQuality;
		}
		}
		}