Player Configuration And Operation With An Xml File - NLS DS1 Manual

Special Features for Libraries and Technicians
3.3

Player Configuration and Operation with an XML file

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>
<Language value="spanish" />
<Verbosity value="normal" />
</configuration>
<directive>
<ResetProfile value="all" />
<BatteryLife />
<ExportStatistics />
<Off />
</directive>
</dtbm>
Tag
Language
Verbosity
Tag
InitialMode
ResetProfile
BatteryLife
ExportStatistics
ExportKey
Off
February 2010
Configuration elements in 'options.xml'
Value
English, Spanish, Ingles,
Espaniol
Normal, Reduced
Directive elements in 'options.xml'
Value
Normal, Service2, Service3
Profile, Keys, All
Digital Talking-Book Player
Library Guide
Set the player to Spanish
Set the verbosity to normal
Clear the bookmarks, last marks & keys
Report the battery condition & software version
Save the accumulated player data to USB drive
Turn off the player
Change the language setting of the player
if different from current configuration.
Change the verbosity setting of the player
if different from current configuration.
Change the mode to the technician or
technician plus service level or leave in
normal mode.
Clear the bookmarks/lastmarks and/or the
user added PDTB1 and PDTB2 keys.
Announce the current charge state,
number of charges for this battery and the
software version.
Save the accumulated statistical data on
the player to a file on the USB drive.
Save the player's public instance key to
the USB drive.
Turn the player off after acting on these
directives.
Section 3
Effect
Effect
42