() {
@Override
public MediaThreshold createFromParcel(@NonNull Parcel in) {
return new MediaThreshold(in);
}
@Override
public MediaThreshold[] newArray(int size) {
return new MediaThreshold[size];
}
};
/**
* Returns whether the RTP packet loss rate threshold is valid or not.
*
* @param packetLossRate packet loss rate
* @return the threshold is valid or not.
* @hide
*/
public static boolean isValidRtpPacketLossRate(int packetLossRate) {
return (packetLossRate >= 0 && packetLossRate <= 100);
}
/**
* Returns whether the RTP jitter threshold is valid or not.
*
* @param jitter jitter value in milliseconds
* @return the threshold is valid or not.
* @hide
*/
public static boolean isValidJitterMillis(int jitter) {
return (jitter >= 0 && jitter <= 10000);
}
/**
* Returns whether the RTP packet loss rate threshold is valid or not.
*
* @param inactivityTime packet loss rate
* @return the threshold is valid or not.
* @hide
*/
public static boolean isValidRtpInactivityTimeMillis(long inactivityTime) {
return (inactivityTime >= 0 && inactivityTime <= 60000);
}
@Override
public int describeContents() {
return 0;
}
@Override
public boolean equals(Object o) {
if (this == o) return true;
if (o == null || getClass() != o.getClass()) return false;
MediaThreshold that = (MediaThreshold) o;
return Arrays.equals(mRtpPacketLossRate, that.mRtpPacketLossRate)
&& Arrays.equals(mRtpJitter, that.mRtpJitter)
&& Arrays.equals(mRtpInactivityTimeMillis, that.mRtpInactivityTimeMillis);
}
@Override
public int hashCode() {
return Objects.hash(Arrays.hashCode(mRtpPacketLossRate), Arrays.hashCode(mRtpJitter),
Arrays.hashCode(mRtpInactivityTimeMillis));
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append("MediaThreshold{mRtpPacketLossRate=");
for (int i : mRtpPacketLossRate) {
sb.append(" ").append(i);
}
sb.append(", mRtpJitter=");
for (int b : mRtpJitter) {
sb.append(" ").append(b);
}
sb.append(", mRtpInactivityTimeMillis=");
for (long i : mRtpInactivityTimeMillis) {
sb.append(" ").append(i);
}
sb.append("}");
return sb.toString();
}
/**
* Provides a convenient way to set the fields of an {@link MediaThreshold} when creating a
* new instance.
*
* The example below shows how you might create a new {@code RtpThreshold}:
*
*
*
* RtpThreshold = new RtpThreshold.Builder()
* .setRtpSessionType({@link MediaQualityStatus#MEDIA_SESSION_TYPE_AUDIO} or
* {@link MediaQualityStatus#MEDIA_SESSION_TYPE_VIDEO})
* .setThresholdsRtpPacketLossRate(int[] packetLossRateThresholds)
* .setThresholdsRtpJitterMillis(int[] jitterThresholds)
* .setThresholdsRtpInactivityTimeMillis(int[] inactivityTimeThresholds)
* .build();
*
*
* @hide
*/
public static final class Builder {
private int[] mRtpPacketLossRate = null;
private int[] mRtpJitter = null;
private long[] mRtpInactivityTimeMillis = null;
/**
* Default constructor for the Builder.
*
* @hide
*/
public Builder() {
}
/**
* Set threshold values for RTP packet loss rate in percentage.
*
* The packet loss calculation should be done at least once per
* second. It should be calculated with at least the last 3 seconds
* of data.
*
* @param packetLossRateThresholds int array for threshold values.
* @return The same instance of the builder.
*
* @hide
*/
@NonNull
public Builder setThresholdsRtpPacketLossRate(int[] packetLossRateThresholds) {
if (packetLossRateThresholds.length > 0) {
TreeSet thresholds = new TreeSet<>();
for (Integer value : packetLossRateThresholds) {
if (isValidRtpPacketLossRate(value)) {
thresholds.add(value);
}
}
int[] targetArray = new int[thresholds.size()];
int i = 0;
for (int element : thresholds) {
targetArray[i++] = element;
}
this.mRtpPacketLossRate = targetArray;
} else {
this.mRtpPacketLossRate = packetLossRateThresholds;
}
return this;
}
/**
* Set threshold values for RTP jitter in Milliseconds.
*
* @param jitterThresholds int array including threshold values for Jitter.
* @return The same instance of the builder.
*
* @hide
*/
@NonNull
public Builder setThresholdsRtpJitterMillis(int[] jitterThresholds) {
if (jitterThresholds.length > 0) {
TreeSet thresholds = new TreeSet<>();
for (Integer value : jitterThresholds) {
if (isValidJitterMillis(value)) {
thresholds.add(value);
}
}
int[] targetArray = new int[thresholds.size()];
int i = 0;
for (int element : thresholds) {
targetArray[i++] = element;
}
this.mRtpJitter = targetArray;
} else {
this.mRtpJitter = jitterThresholds;
}
return this;
}
/**
* Set threshold values for RTP inactivity time.
*
* @param inactivityTimeThresholds int array including threshold
* values for RTP inactivity time.
* @return The same instance of the builder.
*
* @hide
*/
@NonNull
public Builder setThresholdsRtpInactivityTimeMillis(long[] inactivityTimeThresholds) {
if (inactivityTimeThresholds.length > 0) {
TreeSet thresholds = new TreeSet<>();
for (Long value : inactivityTimeThresholds) {
if (isValidRtpInactivityTimeMillis(value)) {
thresholds.add(value);
}
}
long[] targetArray = new long[thresholds.size()];
int i = 0;
for (long element : thresholds) {
targetArray[i++] = element;
}
this.mRtpInactivityTimeMillis = targetArray;
} else {
this.mRtpInactivityTimeMillis = inactivityTimeThresholds;
}
return this;
}
/**
* Build the {@link MediaThreshold}
*
* @return the {@link MediaThreshold} object
*
* @hide
*/
@NonNull
public MediaThreshold build() {
mRtpPacketLossRate = mRtpPacketLossRate != null ? mRtpPacketLossRate : new int[0];
mRtpJitter = mRtpJitter != null ? mRtpJitter : new int[0];
mRtpInactivityTimeMillis =
mRtpInactivityTimeMillis != null ? mRtpInactivityTimeMillis : new long[0];
return new MediaThreshold(mRtpPacketLossRate, mRtpJitter, mRtpInactivityTimeMillis);
}
}
}