X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;f=doc%2Fafb-plugins-overview.html;h=216a80acfb3a51fdbc9ae308574195e28c653a89;hb=1.0;hp=f67826b98dd439d545f93ba118b19851d5aad247;hpb=89db34aa9ee65a42ce242e95f342a7323c1e0e1b;p=src%2Fapp-framework-binder.git diff --git a/doc/afb-plugins-overview.html b/doc/afb-plugins-overview.html index f67826b9..216a80ac 100644 --- a/doc/afb-plugins-overview.html +++ b/doc/afb-plugins-overview.html @@ -4,78 +4,162 @@
+Version: 1
-Date: 30 May 2016
+Date: 30 mai 2016
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.
+### Hello World
+ +A sample Hello World plugin for demonstration and learning purposes.
-This plugin provides a few unauthenticated requests, all beginning with "ping" ("pingSample", "pingJson", "pingFail"...) to demonstrate basic binder capabilities.
+This plugin provides a few unauthenticated requests, all beginning with “ping”, to demonstrate basic binder capabilities.
+ +Verbs:
+ +### Authentication
+ +An sample Authentication plugin for demonstration purposes.
-This plugin provides a few requests to demonstrate the binder's token-based security mechanism.
+This plugin provides a few requests to demonstrate the binder’s token-based security mechanism.
+ +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.
-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:
-### Tic Tac Toe
+A sample Tic Tac Toe game plugin.
-This plugin provides an interactive Tic Tac Toe game where the binder returns the grid as a JSON response.
+This plugin provides an interactive Tic Tac Toe game where the binder returns the grid as a JSON response.
-### Audio
+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:
+ +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.
(if PulseAudio development libraries are not found at build time, only ALSA will be available)
(if a PulseAudio server is not found at runtime, the plugin will dynamically fall back to ALSA)
-(a specifc backend can be forced by using this syntax before running afb-daemon : $ export AFBAUDIOOUTPUT=Alsa)
+(a specifc backend can be forced by using this syntax before running afb-daemon : $ export AFB_AUDIO_OUTPUT=Alsa)
-### Radio
+A sample AM/FM Radio plugin with 1 backend: - * RTLSDR - Realtek RTL2832U dongles (mandatory)
+A sample Media Server 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).
+(if rtlsdr development libraries are not found at build time, this plugin will not be built)
-### Media
+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.
-A sample Media Server plugin with 1 backend: - * Rygel
+Verbs:
-(if GUPnP/GSSDP development libraries are not found at build time, this plugin will not be built)
+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.
+ +(if GUPnP/GSSDP development libraries are not fund at build time, this plugin will not be built)
+ +