Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Add 5 Jitter-related and 2 RTP-related parameters to call quality"

Browse Source
This commit is contained in:
Nina Chueh
2022-01-07 02:57:06 +00:00
committed by Android (Google) Code Review
parent d933494408 3b601a0745
commit 30530053e1
2 changed files with 448 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

33
core/api/system-current.txt
View File

@@ -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();

417
telephony/java/android/telephony/CallQuality.java
View File

@@ -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;
}
}
}