protocol.GetTracksByTypeRequest2
This request allows you to get all the tracks of the desired track type, sorted by desired metadata field. An optional indices parameter can be passed if you wish to subset the returned list if you have a limit on the number of results you can display on your user interface. There is also an optional parameter that allows you to just get a slice of results around a matching string. This is useful if you are randomly jumping around in the results for example alphabetically.
Parameter | Optional | Max Allowed | DataType | Notes |
---|---|---|---|---|
cid | no | 1 | text | client id. used to track origin of any particular message |
type | no | 1 | integer | track type |
sort | no | 1 | text | media type to sort by |
ixs | yes | 1 | indices | start (i0) and end (i1) index inclusive |
sli | yes | 1 | slice | pivot returned results around matching string (ss) with number of items before (w0) and after (w1) matching string |
Example xml:
<sireq> <cid>Mum</cid> <fn> <getTracksByType> <type>0</type> <sort>track</sort> <ixs> <i0>0</i0> <i1>9</i1> </ixs> <sli> <ss>a</ss> <w0>50</w0> <w1>50</w1> </sli> </getTracksByType> </fn> </sireq>