+ * It defaults to the standard value associated with this itag and is set to the {@code fps} + * value returned in the corresponding itag in the YouTube player response. + *
+ * + *+ * Note that this value is only known for video itags, so {@link + * #FPS_NOT_APPLICABLE_OR_UNKNOWN} is returned for non video itags. + *
+ * + * @return the frame rate per second or {@link #FPS_NOT_APPLICABLE_OR_UNKNOWN} + */ + public int getFps() { + return fps; + } + + /** + * Set the frame rate per second. + * + *+ * It is only known for video itags, so {@link #FPS_NOT_APPLICABLE_OR_UNKNOWN} is set/used for + * non video itags or if the sample rate value is less than or equal to 0. + *
+ * + * @param fps the frame rate per second + */ + public void setFps(final int fps) { + if (fps > 0) { + this.fps = fps; + } else { + this.fps = FPS_NOT_APPLICABLE_OR_UNKNOWN; + } + } + public int getInitStart() { return initStart; } @@ -251,6 +313,21 @@ public class ItagItem { this.quality = quality; } + /** + * Get the resolution string associated to this {@code ItagItem}. + * + *+ * It is only known for video itags. + *
+ * + * @return the resolution string associated to this {@code ItagItem} or + * {@code null}. + */ + @Nullable + public String getResolutionString() { + return resolutionString; + } + public String getCodec() { return codec; } @@ -258,4 +335,194 @@ public class ItagItem { public void setCodec(final String codec) { this.codec = codec; } + + /** + * Get the average bitrate. + * + *+ * It is only known for audio itags, so {@link #AVERAGE_BITRATE_UNKNOWN} is always returned for + * other itag types. + *
+ * + *+ * Bitrate of video itags and precise bitrate of audio itags can be known using + * {@link #getBitrate()}. + *
+ * + * @return the average bitrate or {@link #AVERAGE_BITRATE_UNKNOWN} + * @see #getBitrate() + */ + public int getAverageBitrate() { + return avgBitrate; + } + + /** + * Get the sample rate. + * + *+ * It is only known for audio itags, so {@link #SAMPLE_RATE_UNKNOWN} is returned for non audio + * itags or if the sample rate is unknown. + *
+ * + * @return the sample rate or {@link #SAMPLE_RATE_UNKNOWN} + */ + public int getSampleRate() { + return sampleRate; + } + + /** + * Set the sample rate. + * + *+ * It is only known for audio itags, so {@link #SAMPLE_RATE_UNKNOWN} is set/used for non video + * itags or if the sample rate value is less than or equal to 0. + *
+ * + * @param sampleRate the sample rate of an audio itag + */ + public void setSampleRate(final int sampleRate) { + if (sampleRate > 0) { + this.sampleRate = sampleRate; + } else { + this.sampleRate = SAMPLE_RATE_UNKNOWN; + } + } + + /** + * Get the number of audio channels. + * + *+ * It is only known for audio streams, so {@link #AUDIO_CHANNELS_NOT_APPLICABLE_OR_UNKNOWN} is + * returned for video streams or if it is unknown. + *
+ * + * @return the number of audio channels or {@link #AUDIO_CHANNELS_NOT_APPLICABLE_OR_UNKNOWN} + */ + public int getAudioChannels() { + return audioChannels; + } + + /** + * Set the number of audio channels. + * + *+ * It is only known for audio itag, so {@link #AUDIO_CHANNELS_NOT_APPLICABLE_OR_UNKNOWN} is + * set/used for non audio itags or if the {@code audioChannels} value is less than or equal to + * 0. + *
+ * + * @param audioChannels the number of audio channels of an audio itag + */ + public void setAudioChannels(final int audioChannels) { + if (audioChannels > 0) { + this.audioChannels = audioChannels; + } else { + this.audioChannels = AUDIO_CHANNELS_NOT_APPLICABLE_OR_UNKNOWN; + } + } + + /** + * Get the {@code targetDurationSec} value. + * + *+ * This value is an average time in seconds of sequences duration of livestreams and ended + * livestreams. It is only returned for these stream types by YouTube and makes no sense for + * videos, so {@link #TARGET_DURATION_SEC_UNKNOWN} is returned for video streams. + *
+ * + * @return the {@code targetDurationSec} value or {@link #TARGET_DURATION_SEC_UNKNOWN} + */ + public int getTargetDurationSec() { + return targetDurationSec; + } + + /** + * Set the {@code targetDurationSec} value. + * + *+ * This value is an average time in seconds of sequences duration of livestreams and ended + * livestreams. + *
+ * + *+ * It is only returned for these stream types by YouTube and makes no sense for + * videos, so {@link #TARGET_DURATION_SEC_UNKNOWN} will be set/used for video streams or if + * this value is less than or equal to 0. + *
+ * + * @param targetDurationSec the target duration of a segment of streams which are using the + * live delivery method type + */ + public void setTargetDurationSec(final int targetDurationSec) { + if (targetDurationSec > 0) { + this.targetDurationSec = targetDurationSec; + } else { + this.targetDurationSec = TARGET_DURATION_SEC_UNKNOWN; + } + } + + /** + * Get the {@code approxDurationMs} value. + * + *+ * It is only known for DASH progressive streams, so {@link #APPROX_DURATION_MS_UNKNOWN} is + * returned for other stream types or if this value is less than or equal to 0. + *
+ * + * @return the {@code approxDurationMs} value or {@link #APPROX_DURATION_MS_UNKNOWN} + */ + public long getApproxDurationMs() { + return approxDurationMs; + } + + /** + * Set the {@code approxDurationMs} value. + * + *+ * It is only known for DASH progressive streams, so {@link #APPROX_DURATION_MS_UNKNOWN} is + * set/used for other stream types or if this value is less than or equal to 0. + *
+ * + * @param approxDurationMs the approximate duration of a DASH progressive stream, in + * milliseconds + */ + public void setApproxDurationMs(final long approxDurationMs) { + if (approxDurationMs > 0) { + this.approxDurationMs = approxDurationMs; + } else { + this.approxDurationMs = APPROX_DURATION_MS_UNKNOWN; + } + } + + /** + * Get the {@code contentLength} value. + * + *+ * It is only known for DASH progressive streams, so {@link #CONTENT_LENGTH_UNKNOWN} is + * returned for other stream types or if this value is less than or equal to 0. + *
+ * + * @return the {@code contentLength} value or {@link #CONTENT_LENGTH_UNKNOWN} + */ + public long getContentLength() { + return contentLength; + } + + /** + * Set the content length of stream. + * + *+ * It is only known for DASH progressive streams, so {@link #CONTENT_LENGTH_UNKNOWN} is + * set/used for other stream types or if this value is less than or equal to 0. + *
+ * + * @param contentLength the content length of a DASH progressive stream + */ + public void setContentLength(final long contentLength) { + if (contentLength > 0) { + this.contentLength = contentLength; + } else { + this.contentLength = CONTENT_LENGTH_UNKNOWN; + } + } }