MJPlaylistAutomation: Difference between revisions

From wiki.jriver.com
Jump to navigation Jump to search
No edit summary
 
(One intermediate revision by one other user not shown)
Line 28: Line 28:
'''Return Value:''' the value of the property for this playlist<br>
'''Return Value:''' the value of the property for this playlist<br>
'''Properties (not complete list):'''
'''Properties (not complete list):'''
* '''Type''': 0 = normal playlist, 1 = playlist folder, 2 = Smartlist, 3 = Special (e.g. 'Current Playcharts')
* '''Type''': 0 = playlist, 1 = playlist group, 2 = smartlist, 3 = special (e.g. 'Current Playcharts')


===void Set(string strProperty, string bstrValue)===
===void Set(string strProperty, string bstrValue)===
Line 51: Line 51:
===string Path() (read / write)===
===string Path() (read / write)===
'''Description:''' the path of the playlist, delimited by backslashes (note: does not contain the name) (i.e. "Mixes\\New Playlist Group")<br>
'''Description:''' the path of the playlist, delimited by backslashes (note: does not contain the name) (i.e. "Mixes\\New Playlist Group")<br>

[[Category:COM Automation]]

Latest revision as of 05:39, 4 May 2015

interface for working with a single playlist

Functions[edit]

MJFilesAutomation * GetFiles()[edit]

Description: gets the collection of files in the playlist
Return Value: MJFilesAutomation interface

boolean AddFile(string strFilename, number nLocation)[edit]

Description: adds new file to the playlist
Parameters:

  • strFilename: the filename of the file to add
  • nLocation: position of the file in the playlist. If position -1, the file will be added to the end of the playlist.

Return Value: 0 on failure, non-zero on success

boolean RemoveFile(string strFilename)[edit]

Description: removes existing file from the playlist
Parameters:

  • strFilename: the filename of the file to delete

Return Value: 0 on failure, non-zero on success

long GetID()[edit]

Description: returns the ID associated with a playlist
Return Value: the ID

string Get(string bstrProperty)[edit]

Description: lookup a property associated with a playlist
Parameters:

  • bstrProperty: the name of the property

Return Value: the value of the property for this playlist
Properties (not complete list):

  • Type: 0 = playlist, 1 = playlist group, 2 = smartlist, 3 = special (e.g. 'Current Playcharts')

void Set(string strProperty, string bstrValue)[edit]

Description: change the value of a property for this playlist
Parameters:

  • strProperty: the property name
  • bstrValue: The new value

boolean SaveAsRSS(string strFilename, string strURLPrefix, string strUser, string strEmail)[edit]

Description: 11.1.134 or higher, saves the playlist as an RSS (PodCast/PerbCast) file
Parameters:

  • strFilename: the filename of the RSS file
  • strURLPrefix: The URL prefix which will be concatenated with the keys of the playlist files to form the URL for accessing them
  • strUser: the name of the PerbCast creator
  • strEmail: the e-mail address of the PerbCast creator

Return Value: 0 on failure, non-zero on success

Properties[edit]

string Name() (read / write)[edit]

Description: the name of the playlist (i.e. "My Playlist")

string Path() (read / write)[edit]

Description: the path of the playlist, delimited by backslashes (note: does not contain the name) (i.e. "Mixes\\New Playlist Group")