User Tools

Site Tools


reference:logging_variables

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
reference:logging_variables [2015/09/01 14:21] – created twreference:logging_variables [2021/08/20 06:44] (current) – [General variables] %% inserted ulinobbe
Line 10: Line 10:
 | %m | Current minute as MM | | %m | Current minute as MM |
 | %s | Current second as SS | | %s | Current second as SS |
-| %w | IOS8601 week of the year |+| %w | ISO 8601 week of the year |
 | %T{Format} | Current date/time, using ''FormatDateTime'' formatting (see below) | | %T{Format} | Current date/time, using ''FormatDateTime'' formatting (see below) |
 | %S{Format} | Start time in ''FormatDateTime'' formatting (used for stop logging) | | %S{Format} | Start time in ''FormatDateTime'' formatting (used for stop logging) |
Line 16: Line 16:
 | %r | CR character (ASCII 13) | | %r | CR character (ASCII 13) |
 | %n | Newline Character (ASCII 10) | | %n | Newline Character (ASCII 10) |
-| %g | Uniqud identifier of the associated playback operation |+| %% | Creates a ''%'' sign in the output | 
 +| %g | Unique identifier of the associated playback operation |
 | %R{Key} | Runtime data | | %R{Key} | Runtime data |
 | %# | Total number of current listeners on all encoder connections | | %# | Total number of current listeners on all encoder connections |
-| %Actual playback duration, in seconds +| %${Digits} Index of file (used for file export with custom filename pattern) 
-| %Actual playback duration, in seconds with fraction |+| %Computer name | 
 +| %X | Instance name |
  
-==== Information about the item being played ====+===== Information about the item being played =====
  
 | %a | Artist | | %a | Artist |
 | %b | Title | | %b | Title |
-| %l | Duration, in sections with fractions | +| %l | Total duration, in seconds with fractions 
-| %L | Duration, as HH:MM:SS |+| %l{Format} | Total duration, in ''FormatDateTime'' format 
 +| %L | Total duration, as HH:MM:SS 
 +| %d | Actual playback duration, in DirectSound units seconds (for stop logging) | 
 +| %e | Actual playback duration, in seconds with fractions (for stop logging) | 
 +| %e{Format} | Actual playback duration, in ''FormatDateTime'' format (for stop logging) | 
 +| %p | Effective playback duration, in seconds with fractions | 
 +| %p{Format} | Effective playback duration, in ''FormatDateTime'' format (from v6.3 on) | 
 +| %P | Effective playback duration, as HH:MM:SS | 
 +| %F | Projected finish time (start time + duration), in ''FormatDateTime'' format |
 | %c{Type} | Cue marker, in sections with fractions | | %c{Type} | Cue marker, in sections with fractions |
 | %E | End type | | %E | End type |
Line 43: Line 53:
 | %4 | Filename without path, first character only | | %4 | Filename without path, first character only |
 | %i{Key} | Raw file tag data | | %i{Key} | Raw file tag data |
 +===== Additional variables for HTTP POST multipart/form-data logging =====
  
-=== FormatDateTime ===+The following variables are only supported in HTTP POST multipart/form-data logging. 
 + 
 +They must be typed into the "value" field as is, with no other strings/variables around them. 
 + 
 +| %ALBUMART | Album art (if available), as binary form data (from v6.3.3) | 
 + 
 + 
 +===== Additional variables for playlist/advertising import (filename pattern) ===== 
 + 
 +| %B | Block number | 
 +| %2B | Block number, two digits, leading 0 | 
 +| %3B | Block number, three digits, leading 0 | 
 +| %N | Region number | 
 +| %2N | Region number, two digits, leading 0 | 
 +| %3N | Region number, three digits, leading 0 | 
 + 
 + 
 +===== FormatDateTime =====
  
 Some variables expect a time format string in Delphi's FormatDateTime notation, see http://www.delphibasics.co.uk/RTL.asp?Name=FormatDateTime  Some variables expect a time format string in Delphi's FormatDateTime notation, see http://www.delphibasics.co.uk/RTL.asp?Name=FormatDateTime 
 +
 +===== Subsequent items =====
 +
 +By using ''+'' signs in the variables, you can access the data of the subsequent (next) items in the playlist.
 +
 +For example ''%+a'' retrieves the artist of the next item, not the current one, ''%++a'' the artist of the item after the next item, and so on.
 +
 +For performance reasons, the number of items considered/available is limited to 3 by default. You can adjust this value through a manual setting in mAirList.ini:
 +
 +  [Options]
 +  NextLoggingLimit=10
 +  
 +Please note that this limit applies to the **overall** number of subsequent items available for logging, before any possible item type filtering. So if you want to log e.g. the next 3 "Music" items, but there are times when there are 4 non-music items in between (jingles, news, advertising, etc.), you must set the limit to 7 or higher.
reference/logging_variables.1441117260.txt.gz · Last modified: 2019/07/09 16:19 (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki