Kodi Documentation 22.0
Kodi is an open source media player and entertainment hub.
|
Data structure with available recordings data
With this, recordings related data are transferred between addon and Kodi and can also be used by the addon itself.
More...
Topics | |
Value Help | |
class PVRRecordingsResultSet | |
PVR add-on recording transfer class To transfer the content of kodi::addon::CInstancePVRClient::GetRecordings(). | |
Classes | |
class | kodi::addon::PVRRecording |
Macros | |
#define | PVR_RECORDING_INVALID_SERIES_EPISODE -1 |
Special kodi::addon::PVRRecording::SetSeriesNumber() and kodi::addon::PVRRecording::SetEpisodeNumber() and kodi::addon::PVRRecording::SetEpisodePartNumber() value to indicate it is not to be used. | |
#define | PVR_RECORDING_VALUE_NOT_AVAILABLE -1 |
Value where set in background to inform that related part not used. | |
Functions | |
void | kodi::addon::PVRRecording::SetRecordingId (const std::string &recordingId) |
required Unique identifier of the recording on the client. | |
std::string | kodi::addon::PVRRecording::GetRecordingId () const |
To get with SetRecordingId changed values. | |
void | kodi::addon::PVRRecording::SetTitle (const std::string &title) |
required The title of this recording. | |
std::string | kodi::addon::PVRRecording::GetTitle () const |
To get with SetTitle changed values. | |
void | kodi::addon::PVRRecording::SetEpisodeName (const std::string &episodeName) |
optional Episode name (also known as subtitle). | |
std::string | kodi::addon::PVRRecording::GetEpisodeName () const |
To get with SetEpisodeName changed values. | |
void | kodi::addon::PVRRecording::SetSeriesNumber (int seriesNumber) |
optional Series number (usually called season). | |
int | kodi::addon::PVRRecording::GetSeriesNumber () const |
To get with SetSeriesNumber changed values. | |
void | kodi::addon::PVRRecording::SetEpisodeNumber (int episodeNumber) |
optional Eepisode number within the "iSeriesNumber" season. | |
int | kodi::addon::PVRRecording::GetEpisodeNumber () const |
To get with SetEpisodeNumber changed values. | |
void | kodi::addon::PVRRecording::SetEpisodePartNumber (int episodePartNumber) |
optional Episode part number. | |
int | kodi::addon::PVRRecording::GetEpisodePartNumber () const |
To get with SetEpisodePartNumber changed values. | |
void | kodi::addon::PVRRecording::SetYear (int year) |
optional Year of first release (use to identify a specific movie re-make) / first airing for TV shows. | |
int | kodi::addon::PVRRecording::GetYear () const |
To get with SetYear changed values. | |
void | kodi::addon::PVRRecording::SetDirectory (const std::string &directory) |
optional | |
std::string | kodi::addon::PVRRecording::GetDirectory () const |
To get with SetDirectory changed values. | |
void | kodi::addon::PVRRecording::SetPlotOutline (const std::string &plotOutline) |
optional Plot outline name. | |
std::string | kodi::addon::PVRRecording::GetPlotOutline () const |
To get with SetPlotOutline changed values. | |
void | kodi::addon::PVRRecording::SetPlot (const std::string &plot) |
optional Plot name. | |
std::string | kodi::addon::PVRRecording::GetPlot () const |
To get with SetPlot changed values. | |
void | kodi::addon::PVRRecording::SetChannelName (const std::string &channelName) |
optional Channel name. | |
std::string | kodi::addon::PVRRecording::GetChannelName () const |
To get with SetChannelName changed values. | |
void | kodi::addon::PVRRecording::SetIconPath (const std::string &iconPath) |
optional Channel logo (icon) path. | |
std::string | kodi::addon::PVRRecording::GetIconPath () const |
To get with SetIconPath changed values. | |
void | kodi::addon::PVRRecording::SetThumbnailPath (const std::string &thumbnailPath) |
optional Thumbnail path. | |
std::string | kodi::addon::PVRRecording::GetThumbnailPath () const |
To get with SetThumbnailPath changed values. | |
void | kodi::addon::PVRRecording::SetFanartPath (const std::string &fanartPath) |
optional Fanart path. | |
std::string | kodi::addon::PVRRecording::GetFanartPath () const |
To get with SetFanartPath changed values. | |
void | kodi::addon::PVRRecording::SetRecordingTime (time_t recordingTime) |
optional Start time of the recording. | |
time_t | kodi::addon::PVRRecording::GetRecordingTime () const |
To get with SetRecordingTime changed values. | |
void | kodi::addon::PVRRecording::SetDuration (int duration) |
optional Duration of the recording in seconds. | |
int | kodi::addon::PVRRecording::GetDuration () const |
To get with SetDuration changed values. | |
void | kodi::addon::PVRRecording::SetPriority (int priority) |
optional Priority of this recording (from 0 - 100). | |
int | kodi::addon::PVRRecording::GetPriority () const |
To get with SetPriority changed values. | |
void | kodi::addon::PVRRecording::SetLifetime (int lifetime) |
optional Life time in days of this recording. | |
int | kodi::addon::PVRRecording::GetLifetime () const |
To get with SetLifetime changed values. | |
void | kodi::addon::PVRRecording::SetGenreType (int genreType) |
optional Genre type. | |
int | kodi::addon::PVRRecording::GetGenreType () const |
To get with SetGenreType changed values. | |
void | kodi::addon::PVRRecording::SetGenreSubType (int genreSubType) |
optional Genre sub type. | |
int | kodi::addon::PVRRecording::GetGenreSubType () const |
To get with SetGenreSubType changed values. | |
void | kodi::addon::PVRRecording::SetGenreDescription (const std::string &genreDescription) |
optional To set own genre description name. | |
std::string | kodi::addon::PVRRecording::GetGenreDescription () const |
To get with SetGenreDescription changed values. | |
void | kodi::addon::PVRRecording::SetPlayCount (int playCount) |
optional Play count of this recording on the client. | |
int | kodi::addon::PVRRecording::GetPlayCount () const |
To get with SetPlayCount changed values. | |
void | kodi::addon::PVRRecording::SetLastPlayedPosition (int lastPlayedPosition) |
optional Last played position of this recording on the client. | |
int | kodi::addon::PVRRecording::GetLastPlayedPosition () const |
To get with SetLastPlayedPosition changed values. | |
void | kodi::addon::PVRRecording::SetIsDeleted (int isDeleted) |
optional Shows this recording is deleted and can be undelete. | |
int | kodi::addon::PVRRecording::GetIsDeleted () const |
To get with SetIsDeleted changed values. | |
void | kodi::addon::PVRRecording::SetEPGEventId (unsigned int epgEventId) |
optional EPG event id associated with this recording. Valid ids must be greater than EPG_TAG_INVALID_UID. | |
unsigned int | kodi::addon::PVRRecording::GetEPGEventId () const |
To get with SetEPGEventId changed values. | |
void | kodi::addon::PVRRecording::SetChannelUid (int channelUid) |
optional Unique identifier of the channel for this recording. PVR_CHANNEL_INVALID_UID denotes that channel uid is not available. | |
int | kodi::addon::PVRRecording::GetChannelUid () const |
To get with SetChannelUid changed values. | |
void | kodi::addon::PVRRecording::SetChannelType (PVR_RECORDING_CHANNEL_TYPE channelType) |
optional Channel type. | |
PVR_RECORDING_CHANNEL_TYPE | kodi::addon::PVRRecording::GetChannelType () const |
To get with SetChannelType changed values. | |
void | kodi::addon::PVRRecording::SetFirstAired (const std::string &firstAired) |
optional First aired date of this recording. | |
std::string | kodi::addon::PVRRecording::GetFirstAired () const |
To get with SetFirstAired changed values. | |
void | kodi::addon::PVRRecording::SetFlags (unsigned int flags) |
optional Bit field of independent flags associated with the recording. | |
unsigned int | kodi::addon::PVRRecording::GetFlags () const |
To get with SetFlags changed values. | |
void | kodi::addon::PVRRecording::SetSizeInBytes (int64_t sizeInBytes) |
optional Size of the recording in bytes. | |
int64_t | kodi::addon::PVRRecording::GetSizeInBytes () const |
To get with SetSizeInBytes changed values. | |
Data structure with available recordings data
With this, recordings related data are transferred between addon and Kodi and can also be used by the addon itself.
The related values here are automatically initiated to defaults and need only be set if supported and used.
The following table contains values that can be set with class PVRRecording :
Name | Type | Set call | Get call | Usage |
---|---|---|---|---|
Recording id | std::string | SetRecordingId | GetRecordingId | required to set |
Title | std::string | SetTitle | GetTitle | required to set |
Episode name | std::string | SetEpisodeName | GetEpisodeName | optional |
Series number | int | SetSeriesNumber | GetSeriesNumber | optional |
Episode number | int | SetEpisodeNumber | GetEpisodeNumber | optional |
Episode part number | int | SetEpisodePartNumber | GetEpisodePartNumber | optional |
Year | int | SetYear | GetYear | optional |
Directory | std::string | SetDirectory | GetDirectory | optional |
Plot outline | std::string | SetPlotOutline | GetPlotOutline | optional |
Plot | std::string | SetPlot | GetPlot | optional |
Genre description | std::string | SetGenreDescription | GetGenreDescription | optional |
Channel name | std::string | SetChannelName | GetChannelName | optional |
Icon path | std::string | SetIconPath | GetIconPath | optional |
Thumbnail path | std::string | SetThumbnailPath | GetThumbnailPath | optional |
Fanart path | std::string | SetFanartPath | GetFanartPath | optional |
Recording time | time_t | SetRecordingTime | GetRecordingTime | optional |
Duration | int | SetDuration | GetDuration | optional |
Priority | int | SetPriority | GetPriority | optional |
Lifetime | int | SetLifetime | GetLifetime | optional |
Genre type | int | SetGenreType | GetGenreType | optional |
Genre sub type | int | SetGenreSubType | GetGenreSubType | optional |
Play count | int | SetPlayCount | GetPlayCount | optional |
Last played position | int | SetLastPlayedPosition | GetLastPlayedPosition | optional |
Is deleted | bool | SetIsDeleted | GetIsDeleted | optional |
EPG event id | unsigned int | SetEPGEventId | GetEPGEventId | optional |
Channel unique id | int | SetChannelUid | GetChannelUid | optional |
Channel type | PVR_RECORDING_CHANNEL_TYPE | SetChannelType | GetChannelType | optional |
First aired | std::string | SetFirstAired | GetFirstAired | optional |
Flags | std::string | SetFlags | GetFlags | optional |
Size in bytes | std::string | SetSizeInBytes | GetSizeInBytes | optional |
Client provider unique identifier | int | SetClientProviderUid | GetClientProviderUid | optional |
Provider name | std::string | SetProviderlName | GetProviderName | optional |
Parental rating age | unsigned int | SetParentalRating | GetParentalRating | optional |
Parental rating code | std::string | SetParentalRatingCode | GetParentalRatingCode | optional |
Parental rating icon | std::string | SetParentalRatingIcon | GetParentalRatingIcon | optional |
Parental rating source | std::string | SetParentalRatingSource | GetParentalRatingSource | optional |
#define PVR_RECORDING_INVALID_SERIES_EPISODE -1 |
Special kodi::addon::PVRRecording::SetSeriesNumber() and kodi::addon::PVRRecording::SetEpisodeNumber() and kodi::addon::PVRRecording::SetEpisodePartNumber() value to indicate it is not to be used.
Used if recording has no valid season and/or episode info.
#define PVR_RECORDING_VALUE_NOT_AVAILABLE -1 |
Value where set in background to inform that related part not used.
Normally this related parts need not to set by this as it is default.
|
inline |
To get with SetChannelName changed values.
|
inline |
To get with SetChannelType changed values.
|
inline |
To get with SetChannelUid changed values.
|
inline |
To get with SetDirectory changed values.
|
inline |
To get with SetDuration changed values.
|
inline |
To get with SetEPGEventId changed values.
|
inline |
To get with SetEpisodeName changed values.
|
inline |
To get with SetEpisodeNumber changed values.
|
inline |
To get with SetEpisodePartNumber changed values.
|
inline |
To get with SetFanartPath changed values.
|
inline |
To get with SetFirstAired changed values.
|
inline |
To get with SetFlags changed values.
|
inline |
To get with SetGenreDescription changed values.
|
inline |
To get with SetGenreSubType changed values.
|
inline |
To get with SetGenreType changed values.
|
inline |
To get with SetIconPath changed values.
|
inline |
To get with SetIsDeleted changed values.
|
inline |
To get with SetLastPlayedPosition changed values.
|
inline |
To get with SetLifetime changed values.
|
inline |
To get with SetPlayCount changed values.
|
inline |
To get with SetPlot changed values.
|
inline |
To get with SetPlotOutline changed values.
|
inline |
To get with SetPriority changed values.
|
inline |
To get with SetRecordingId changed values.
|
inline |
To get with SetRecordingTime changed values.
|
inline |
To get with SetSeriesNumber changed values.
|
inline |
To get with SetSizeInBytes changed values.
|
inline |
To get with SetThumbnailPath changed values.
|
inline |
To get with SetTitle changed values.
|
inline |
optional
Channel name.
|
inline |
optional
Channel type.
Set to PVR_RECORDING_CHANNEL_TYPE_UNKNOWN if the type cannot be determined.
Example:
optional
Unique identifier of the channel for this recording. PVR_CHANNEL_INVALID_UID denotes that channel uid is not available.
|
inline |
optional
Directory of this recording on the client.
optional
Duration of the recording in seconds.
optional
EPG event id associated with this recording. Valid ids must be greater than EPG_TAG_INVALID_UID.
|
inline |
optional
Episode name (also known as subtitle).
optional
Eepisode number within the "iSeriesNumber" season.
For 'invalid' set to -1 or seriesNumber=episodeNumber=0 to show both are invalid.
optional
Episode part number.
|
inline |
optional
Fanart path.
|
inline |
optional
First aired date of this recording.
Used only for display purposes. Specify in W3C date format "YYYY-MM-DD".
Example:
optional
Bit field of independent flags associated with the recording.
See enum PVR_RECORDING_FLAG for available bit flags.
Here's example about the use of this:
|
inline |
optional
To set own genre description name.
Will be used only when genreType == EPG_GENRE_USE_STRING or genreSubType == EPG_GENRE_USE_STRING.
Use EPG_STRING_TOKEN_SEPARATOR to separate different genres.
In case of other, not ETSI EN 300 468 conform genre types or something special.
Example:
optional
Genre sub type.
Subtypes groups related to set by SetGenreType:
Example:
optional
Genre type.
Use EPG_GENRE_USE_STRING if type becomes given by SetGenreDescription.
Example 1:
Example 2 (in case of other, not ETSI EN 300 468 conform genre types):
|
inline |
optional
Channel logo (icon) path.
optional
Shows this recording is deleted and can be undelete.
optional
Last played position of this recording on the client.
optional
Life time in days of this recording.
optional
Play count of this recording on the client.
|
inline |
optional
Plot name.
|
inline |
optional
Plot outline name.
optional
Priority of this recording (from 0 - 100).
|
inline |
required
Unique identifier of the recording on the client.
|
inline |
optional
Start time of the recording.
optional
Series number (usually called season).
Set to "0" for specials/pilot. For 'invalid' see SetEpisodeNumber or set to -1.
optional
Size of the recording in bytes.
|
inline |
optional
Thumbnail path.
|
inline |
required
The title of this recording.