X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=doc%2Fafb-plugins-overview.html;h=8c7b50fa1a1085af55fe8e1ec41bf504b8ca847f;hb=917b85d762e00662460da5e74b89d43d3355f2ef;hp=b3236886a95c8e9974d53bca0af4345157ec9dd1;hpb=0156b1645a201e44d5285c96d32cbfa5a9eb6814;p=src%2Fapp-framework-binder.git diff --git a/doc/afb-plugins-overview.html b/doc/afb-plugins-overview.html index b3236886..8c7b50fa 100644 --- a/doc/afb-plugins-overview.html +++ b/doc/afb-plugins-overview.html @@ -15,13 +15,17 @@ Author: Manuel Bachmann
Here are the plugins shipped in the source tree: - * Hello World - * Authentication - * Tic Tac Toe - * Audio (2 backends: ALSA/PulseAudio) - * Radio (1 backend: RTLSDR RTL2832U) - * Media (1 backend: Rygel UPnP)
+Here are the plugins shipped in the source tree:
+ +All plugins may not be built, depending on the development libraries present on the system at build time.
@@ -35,13 +39,17 @@ Author: Manuel BachmannThis plugin provides a few unauthenticated requests, all beginning with “ping”, to demonstrate basic binder capabilities.
-Verbs: -* ping: returns a success response -* pingfail: returns a failure response -* pingnull: returns a success response, with an empty JSON response field -* pingbug: does a memory violation (intercepted by the binder) -* pingJson: returns a success response, with a complex JSON response field -* pingevent: broadcasts a global event
+Verbs:
+ +Calling “connect” with a security token will initiate a session, calling “refresh” will issue a new token and invalidate the previous one, calling “logout” will invalidate all tokens and close the session.
-Verbs: -* ping: returns a success response -* connect: creates a session and returns a new token -* refresh: returns a new token -* check: verifies the passed token is valid -* logout: closes the session
+Verbs:
+ +This plugin provides an interactive Tic Tac Toe game where the binder returns the grid as a JSON response.
-Verbs: -* new: starts a new game -* play: asks the server to play -* move: gives a client move -* board: gets the current board state, as a JSON structure -* level: sets the server level -* join: joins an existing board -* undo: undo the last move -* wait: wait for a move
+Verbs:
+ +A sample Audio plugin with 2 backends: - * ALSA (mandatory) - * PulseAudio (optional)
+A sample Audio plugin with 2 backends:
+ +This plugin is able to initialize a specific soundcard, define volume levels, channels (mono/stereo…), mute sound, and play a 22,050 Hz PCM stream.
-Verbs: -* ping: returns a success response -* init: initializes backend, on the “default” sound card -* volume: gets or sets volume, in % (0-100) -* channels: gets or sets channels count (1-8) -* mute: gets or sets the mute status (on-off) -* play: gets or sets the playing status (on-off)
+Verbs:
+ +(if PulseAudio development libraries are not found at build time, only ALSA will be available)
@@ -110,19 +134,27 @@ Author: Manuel BachmannA sample AM/FM Radio plugin with 1 backend: - * RTLSDR - Realtek RTL2832U dongles (mandatory)
+A sample AM/FM Radio plugin with 1 backend:
+ +This plugin is able to initialize specific RTL2832U dongles, switch between AM/FM modes, define frequency, mute sound, and play sound (if combining with the audio plugin).
-Verbs: -* ping: returns a success response -* init: initializes backend, looking for plugged-in devices -* power: sets device power status (on-off) -* mode: sets device reception mode (AM-FM) -* freq: sets device frequency (in Hz) -* mute: sets device mute status (on-off) -* play: sets device playing status (on-off)
+Verbs:
+ +(if rtlsdr development libraries are not found at build time, this plugin will not be built)
@@ -131,21 +163,29 @@ Author: Manuel BachmannA sample Media Server plugin with 1 backend: - * Rygel
+A sample Media Server plugin with 1 backend:
+ +This plugin is able to detect a local Rygel UPnP media server, list audio files, select an audio file for playback, play/pause/seek in this file, upload an audio file to the server.
-Verbs: -* ping: returns a success response -* init: initializes backend, looking for an active local UPnP server -* list: returns list of audio files, as a JSON structure -* select: select an audio files, by index number (001-…) -* play: plays the currently selected audio file -* stop: stops the currently selected audio file -* pause: pauses the currently selected audio file -* seek: seeks in the currently selected audio file, in seconds -* upload: uploads an audio file, with a POST request
+Verbs:
+ +(if GUPnP/GSSDP development libraries are not fund at build time, this plugin will not be built)