Inherits from NSObject
Declared in PTPlaybackInformation.h

Overview

PTPlaybackInformation holds QOS information related to the playback.

Tasks

numberOfSegmentsDownloaded

numberOfMediaRequests

playbackStartDate

URI

  •   URI

    The URI of the playback item. Can be nil.

         property

serverAddress

  •   serverAddress

    The IP address of the server that was the source of the last delivered media segment. Can be nil.

         property

numberOfServerAddressChanges

playbackSessionID

  •   playbackSessionID

    A GUID that identifies the playback session. This value is used in HTTP requests. Can be nil.

         property

playbackStartOffset

  •   playbackStartOffset

    An offset into the playlist where the last uninterrupted period of playback began. Measured in seconds.

         property

segmentsDownloadedDuration

durationWatched

  •   durationWatched

    The accumulated duration of the media played. Measured in seconds.

         property

numberOfStalls

numberOfBytesTransferred

observedBitrate

  •   observedBitrate

    The empirical throughput across all media downloaded. Measured in bits per second.

         property

indicatedBitrate

  •   indicatedBitrate

    The throughput required to play the stream, as advertised by the server. Measured in bits per second.

         property

numberOfDroppedVideoFrames

timeToLoad

timeToStart

timeToFail

totalBufferingTime

secondsSpent

emptyBufferCount

playbackBufferEmpty

  •   playbackBufferEmpty

    Indicates whether playback has consumed all buffered media and that playback will stall or end.

         property

playbackBufferFull

  •   playbackBufferFull

    Indicates whether the internal media buffer is full and that further I/O is suspended.

         property

playbackLikelyToKeepUp

Internal construction

Properties

URI

The URI of the playback item. Can be nil.

@property (nonatomic, retain, readonly) NSString *URI

Discussion

The URI of the playback item. Can be nil.

If nil is returned the URI is unknown. Corresponds to “uri”.

Declared In

PTPlaybackInformation.h

durationWatched

The accumulated duration of the media played. Measured in seconds.

@property (nonatomic, assign, readonly) NSTimeInterval durationWatched

Discussion

The accumulated duration of the media played. Measured in seconds.

Value is negative if unknown. Corresponds to “c-duration-watched”.

Declared In

PTPlaybackInformation.h

emptyBufferCount

The number of playbackBufferEmpty events occurred during playback.

@property (nonatomic, assign, readonly) int emptyBufferCount

Discussion

The number of playbackBufferEmpty events occurred during playback.

Value is 0 if unknown.

Declared In

PTPlaybackInformation.h

indicatedBitrate

The throughput required to play the stream, as advertised by the server. Measured in bits per second.

@property (nonatomic, assign, readonly) double indicatedBitrate

Discussion

The throughput required to play the stream, as advertised by the server. Measured in bits per second.

Value is negative if unknown. Corresponds to “sc-indicated-bitrate”.

Declared In

PTPlaybackInformation.h

numberOfBytesTransferred

The accumulated number of bytes transferred.

@property (nonatomic, assign, readonly) long long numberOfBytesTransferred

Discussion

The accumulated number of bytes transferred.

Value is negative if unknown. Corresponds to “bytes”.

Declared In

PTPlaybackInformation.h

numberOfDroppedVideoFrames

The total number of dropped video frames.

@property (nonatomic, assign, readonly) NSInteger numberOfDroppedVideoFrames

Discussion

The total number of dropped video frames.

Value is negative if unknown. Corresponds to “c-frames-dropped”.

Declared In

PTPlaybackInformation.h

numberOfMediaRequests

A count of media read requests.

@property (nonatomic, assign, readonly) NSInteger numberOfMediaRequests

Discussion

A count of media read requests.

Value is negative if unknown. A count of media read requests from the server to this client. Corresponds to “sc-count”. For HTTP live Streaming, a count of media segments downloaded from the server to this client. For progressive-style HTTP media downloads, a count of HTTP GET (byte-range) requests for the resource. Availability: Available in iOS 6.0 and later. Returns -1 if unavailable.

Declared In

PTPlaybackInformation.h

numberOfSegmentsDownloaded

A count of media segments downloaded.

@property (nonatomic, assign, readonly) NSInteger numberOfSegmentsDownloaded

Discussion

A count of media segments downloaded.

Value is negative if unknown. A count of media segments downloaded from the server to this client. Corresponds to “sc-count”.

Declared In

PTPlaybackInformation.h

numberOfServerAddressChanges

A count of changes to the property serverAddress, see above, over the last uninterrupted period of playback.

@property (nonatomic, assign, readonly) NSInteger numberOfServerAddressChanges

Discussion

A count of changes to the property serverAddress, see above, over the last uninterrupted period of playback.

Value is negative if unknown. Corresponds to “s-ip-changes”.

Declared In

PTPlaybackInformation.h

numberOfStalls

The total number of playback stalls encountered.

@property (nonatomic, assign, readonly) NSInteger numberOfStalls

Discussion

The total number of playback stalls encountered.

Value is negative if unknown. Corresponds to “c-stalls”.

Declared In

PTPlaybackInformation.h

observedBitrate

The empirical throughput across all media downloaded. Measured in bits per second.

@property (nonatomic, assign, readonly) double observedBitrate

Discussion

The empirical throughput across all media downloaded. Measured in bits per second.

Value is negative if unknown. Corresponds to “c-observed-bitrate”.

Declared In

PTPlaybackInformation.h

playbackBufferEmpty

Indicates whether playback has consumed all buffered media and that playback will stall or end.

@property (nonatomic, assign, readonly) BOOL playbackBufferEmpty

Discussion

Indicates whether playback has consumed all buffered media and that playback will stall or end.

Declared In

PTPlaybackInformation.h

playbackBufferFull

Indicates whether the internal media buffer is full and that further I/O is suspended.

@property (nonatomic, assign, readonly) BOOL playbackBufferFull

Discussion

Indicates whether the internal media buffer is full and that further I/O is suspended.

Declared In

PTPlaybackInformation.h

playbackLikelyToKeepUp

Indicates whether the item will likely play through without stalling.

@property (nonatomic, assign, readonly) BOOL playbackLikelyToKeepUp

Discussion

Indicates whether the item will likely play through without stalling.

Declared In

PTPlaybackInformation.h

playbackSessionID

A GUID that identifies the playback session. This value is used in HTTP requests. Can be nil.

@property (nonatomic, retain, readonly) NSString *playbackSessionID

Discussion

A GUID that identifies the playback session. This value is used in HTTP requests. Can be nil.

If nil is returned the GUID is unknown. Corresponds to “cs-guid”.

Declared In

PTPlaybackInformation.h

playbackStartDate

The date/time at which playback began for this event. Can be nil.

@property (nonatomic, retain, readonly) NSDate *playbackStartDate

Discussion

The date/time at which playback began for this event. Can be nil.

If nil is returned the date is unknown. Corresponds to “date”.

Declared In

PTPlaybackInformation.h

playbackStartOffset

An offset into the playlist where the last uninterrupted period of playback began. Measured in seconds.

@property (nonatomic, assign, readonly) NSTimeInterval playbackStartOffset

Discussion

An offset into the playlist where the last uninterrupted period of playback began. Measured in seconds.

Value is negative if unknown. Corresponds to “c-start-time”.

Declared In

PTPlaybackInformation.h

secondsSpent

Total time PTMediaPlayer was in use before it was stopped.

@property (nonatomic, assign, readonly) NSTimeInterval secondsSpent

Discussion

Total time PTMediaPlayer was in use before it was stopped.

Value is 0.0 if unknown.

Declared In

PTPlaybackInformation.h

segmentsDownloadedDuration

The accumulated duration of the media downloaded. Measured in seconds.

@property (nonatomic, assign, readonly) NSTimeInterval segmentsDownloadedDuration

Discussion

The accumulated duration of the media downloaded. Measured in seconds.

Value is negative if unknown. Corresponds to “c-duration-downloaded”.

Declared In

PTPlaybackInformation.h

serverAddress

The IP address of the server that was the source of the last delivered media segment. Can be nil.

@property (nonatomic, retain, readonly) NSString *serverAddress

Discussion

The IP address of the server that was the source of the last delivered media segment. Can be nil.

If nil is returned the address is unknown. Can be either an IPv4 or IPv6 address. Corresponds to “s-ip”.

Declared In

PTPlaybackInformation.h

timeToFail

The time taken to fail for media playback

@property (nonatomic, assign, readonly) NSTimeInterval timeToFail

Discussion

The time taken to fail for media playback

Value is 0.0 if unknown.

Declared In

PTPlaybackInformation.h

timeToLoad

The time taken to load the media

@property (nonatomic, assign, readonly) NSTimeInterval timeToLoad

Discussion

The time taken to load the media

Value is 0.0 if unknown.

Declared In

PTPlaybackInformation.h

timeToStart

The time taken to start the media playback

@property (nonatomic, assign, readonly) NSTimeInterval timeToStart

Discussion

The time taken to start the media playback

Value is 0.0 if unknown.

Declared In

PTPlaybackInformation.h

totalBufferingTime

Total time spent in buffering state during playback.

@property (nonatomic, assign, readonly) NSTimeInterval totalBufferingTime

Discussion

Total time spent in buffering state during playback.

Value is 0.0 if unknown.

Declared In

PTPlaybackInformation.h

Instance Methods

initWithPlaybackMetrics:

Prepares a movie for playback.

- (id)initWithPlaybackMetrics:(PTPlaybackMetrics *)metrics

Discussion

Prepares a movie for playback.

This method is used internaly by the PSDK to create the instances of PTPlaybackInformation.

Declared In

PTPlaybackInformation.h