X-Git-Url: https://gerrit.automotivelinux.org/gerrit/gitweb?a=blobdiff_plain;ds=sidebyside;f=doc%2Fafb-plugins-overview.html;h=8c7b50fa1a1085af55fe8e1ec41bf504b8ca847f;hb=8e83c4de6a2366b96ab950c1d69db830483fb9ff;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..8c7b50fa 100644 --- a/doc/afb-plugins-overview.html +++ b/doc/afb-plugins-overview.html @@ -4,79 +4,193 @@
+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.
+ +Verbs:
+ +A sample Audio plugin with 2 backends:
-### Audio
+A sample Audio plugin with 2 backends: - * ALSA (mandatory) - * PulseAudio (optional)
-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.
+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:
+ +(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)
+ +A sample AM/FM Radio plugin with 1 backend:
-### Radio
+A sample AM/FM Radio plugin with 1 backend: - * RTLSDR - Realtek RTL2832U dongles (mandatory)
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:
+ +(if rtlsdr development libraries are not found at build time, this plugin will not be built)
-### Media
+A sample Media Server plugin with 1 backend:
-A sample Media Server plugin with 1 backend: - * Rygel
+(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.
+Verbs:
+ +(if GUPnP/GSSDP development libraries are not fund at build time, this plugin will not be built)
+ +