From 2907cc6dd0b0d2d80d44ae292a157651d6e05ee7 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 26 Aug 2013 05:25:22 +0000 Subject: player: flesh out multi-source in protocol/sourceedit We should be fully-capable of managing any number of options to try sources in. --- Documentation/dtas-player_protocol.txt | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'Documentation/dtas-player_protocol.txt') diff --git a/Documentation/dtas-player_protocol.txt b/Documentation/dtas-player_protocol.txt index 360eb84..07d14ec 100644 --- a/Documentation/dtas-player_protocol.txt +++ b/Documentation/dtas-player_protocol.txt @@ -33,6 +33,7 @@ dtas-sinkedit(1), and dtas-enq(1) also implement this protocol. - ENVVALUE - must be a suitable environment variable (setenv(3)) - COMMAND, this may be quoted string passed to sh -c "", variable/argument expansion will be performed by the shell +- SOURCENAME - "sox" or "av", more backends may be supported in the future - FILENAME - an expanded pathname relative to / is recommended since dtas-player and the client may run in different directories @@ -167,14 +168,15 @@ For little-endian machines, $ECAFMT defaults to: -fs32_le,2,44100 + nonblock=BOOLEAN - drop audio data to avoid holding back other sinks + pipe_size=UNSIGNED - set the size of the pipe for the sink (Linux-only) -* source cat - dump the current source command and env in YAML +* source SOURCENAME cat - dump the current source command and env in YAML -* source ed SOURCEARGS - edit the source (decoder) command and environment. +* source ed SOURCENAME SOURCEARGS - edit the source parameters. This changes here will immediately restart the source process. See the code for dtas-sourceedit(1) for an example of using this. + command=COMMAND - change the command-line used to decode audio + env.ENVNAME=ENVVALUE - set ENVNAME to ENVVALUE for the source process + env#ENVNAME - unset ENVNAME in the source process (only) + + tryorder=INTEGER - lower values are tried first * watch - adds the client to the passive watch list for notifications. It is recommended clients issue no further commands and open -- cgit v1.2.3-24-ge0c7