Special Features for Libraries and Technicians
Section 3
Player Configuration and Operation with an XML file
January 2009
Digital Talking-Book Player
41
3.3
It is possible to automate some configuration and service operations of the player by using an XML file containing
one or more text instructions. The player will examine this file, called
options.xml
, if present in top most (root)
directory of the cartridge or USB drive. The file has two parts. The first is the configuration section which contains
the commands that set non–volatile settings such as the language or verbosity. The other section contains one time
directives such as clearing the book profile or exporting the statistics to the USB drive.
Example of an ‘options.xml’ file used to setup a player prior to distribution to a patron
<?xml version="1.0" encoding="utf-8"?>
<dtbm xmlns="http://www.loc.gov/nls/DTBM">
<configuration>
Set the player to Spanish
<Language value="spanish" />
Set the verbosity to normal
<Verbosity value="normal" />
</configuration>
<directive>
Clear the bookmarks, last marks & keys
<ResetProfile value="all" />
Report the battery condition & software version
<BatteryLife />
Save the accumulated player data to USB drive
<ExportStatistics />
Turn off the player
<Off />
</directive>
</dtbm>
Configuration elements in ‘options.xml’
Tag Value
Effect
Change the language setting of the player
if different from current configuration.
English, Spanish, Inglese,
Espaniol
Language
Change the verbosity setting of the player
if different from current configuration.
Verbosity Normal,
Reduced
Directive elements in ‘options.xml’
Tag Value
Effect
Change the mode to the technician or
technician plus service level or leave in
normal mode.
InitialMode
Normal, Service2, Service3
Clear the bookmarks/lastmarks and/or the
user added PDTB1 and PDTB2 keys.
ResetProfile Profile,
Keys,
All
BatteryLife
Announce the current charge state,
number of charges for this battery and the
software version.
ExportStatistics
Save the accumulated statistical data on
the player to a file on the USB drive.
ExportKey
Save the player’s public instance key to
the USB drive.
Off
Turn the player off after acting on these
directives.
Library Guide