From 0957981a3b17a63ccdeb425d5b778af0faad7a47 Mon Sep 17 00:00:00 2001 From: Kazumasa Mitsunari Date: Tue, 5 Feb 2019 11:27:02 +0900 Subject: Fix documentation in valid markdown Using markdownlint, fix the document in valid markdown Bug-AGL: SPEC-2102 Change-Id: Ia6b753b8781227f2384c688dee4b5ff0304ff552 Signed-off-by: Kazumasa Mitsunari --- doc/ApplicationGuide.md | 64 +++++++++++++++++++--------------------- doc/Display_Audio_Transition1.md | 1 + doc/Display_Audio_Transition2.md | 1 + 3 files changed, 33 insertions(+), 33 deletions(-) diff --git a/doc/ApplicationGuide.md b/doc/ApplicationGuide.md index 19c82af..3bcde53 100644 --- a/doc/ApplicationGuide.md +++ b/doc/ApplicationGuide.md @@ -14,28 +14,28 @@ - [Target reader of this document](#Target\ reader\ of\ this\ document) - [Overview](#Overview) - [Getting Start](#Getting\ Start) - - [Supported environment](#Supported\ environment) - - [Build](#Build) - - [Configuring](#Configuring) - - [Additional work](#Additional\ work) - - [How to call Sound Manager's APIs from your Application?](#How\ to\ call\ Sound\ Manager\ APIs\ from\ your\ Application?) + - [Supported environment](#Supported\ environment) + - [Build](#Build) + - [Configuring](#Configuring) + - [Additional work](#Additional\ work) + - [How to call Sound Manager's APIs from your Application?](#How\ to\ call\ Sound\ Manager\ APIs\ from\ your\ Application?) - [Supported usecase](#Supported\ usecase) - [Software Architecture](#Software\ Architecture) - [API reference](#API\ reference) - - [APIs](#APIs) - - [Events](#Events) + - [APIs](#APIs) + - [Events](#Events) - [Sequence](#Sequence) - - [StartUp](#StartUp) - - [Registration](#Registration) - - [Request Sound Right](#Request\ Sound\ Right) - - [Connect Sound Route](#Connect\ Sound\ Route) - - [Start Sound Streaming](#Start\ Sound\ Streaming) - - [Stop Sound Streaming](#Stop\ Sound\ Streaming) - - [Disconnect Sound Route](#Disconnect\ Sound\ Route) - - [Change Volume](#Change\ Volume) - - [Set Mute State](#Set\ Mute\ State) - - [Release Sound Right](#Release\ Sound\ Right) - - [Audio Domain](#Audio\ Domain) + - [StartUp](#StartUp) + - [Registration](#Registration) + - [Request Sound Right](#Request\ Sound\ Right) + - [Connect Sound Route](#Connect\ Sound\ Route) + - [Start Sound Streaming](#Start\ Sound\ Streaming) + - [Stop Sound Streaming](#Stop\ Sound\ Streaming) + - [Disconnect Sound Route](#Disconnect\ Sound\ Route) + - [Change Volume](#Change\ Volume) + - [Set Mute State](#Set\ Mute\ State) + - [Release Sound Right](#Release\ Sound\ Right) + - [Audio Domain](#Audio\ Domain) - [Sample code](#Sample\ code) - [Limitation](#Limitation) @@ -59,10 +59,12 @@ The reason why this service is based on GENIVI Audio Manager is because GENIVI A In order to understand, the below figure shows the one of typical usecases. In this example, there are four sound mode. + 1. Audio Off 1. Media Player 1. Tel (Ring and talking) 1. TTS (Text To Speech; typically it's used by Navigation sound) + ![Figure: Typical usecase](parts/typical-usecase.png) The important points are: @@ -104,7 +106,8 @@ Of course user can customize shortcut menu, but since it's too many states so th You can make Sound Manager object files by the following two stage operations. -**Download recipe** +#### Download recipe + If repo is already done, please start with git clone ```bash @@ -114,7 +117,7 @@ repo init -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo repo sync ``` -**Bitbake** +#### Bitbake ```bash source meta-agl/scripts/aglsetup.sh -m m3ulcb agl-demo agl-devel agl-appfw-smack agl-hmi-framework @@ -172,8 +175,6 @@ Please also refer sample application and template. See also our [Sample code](#Sample\ code). -
- * * *
@@ -227,14 +228,15 @@ The communication protocols between libsoundmanager and upper binder, upper bind "libsoundmanager" and "soundmanager_binding" provides several kinds of APIs, and these APIs basically correspond to GENIVI Audio Manager API. (Some APIs are Sound Manager original functions.) For understanding, GENIVI Audio Manager stands for one core module and three plug-ins. + 1. AudioManagerDaemon - This is a core module of Audio Manager. + This is a core module of Audio Manager. 2. AudioManagerCommandPlugin - This is a command interface for Audio Manager. + This is a command interface for Audio Manager. 3. AudioManagerController - This plug-in can be used for sound-right management. + This plug-in can be used for sound-right management. 4. AudioManagerRountingPlugin - This plug-in abstracts the hardware and software. And sometimes there may be multiple plug-ins. + This plug-in abstracts the hardware and software. And sometimes there may be multiple plug-ins. *) [See also GENIVI AudioManager Components](http://docs.projects.genivi.org/AudioManager/audiomanagercomponentspage.html) @@ -363,7 +365,7 @@ Although strongly recommended to read whole pages, but you can get quick underst
-# Sample code +## Sample code You can find samples using Sound Manager as below. @@ -372,10 +374,6 @@ You can find samples using Sound Manager as below.
-# Limitation - -- Minimum APIs and Events are prepared for RC2, the following APIs will be available for final version of EE. - -- getListMainSinks +## Limitation -- Sound of application is not automatically muted for now because Audio Manager doesn't automatically stop with current plugins. +- Sound of application is not automatically muted for now because Audio Manager doesn't stop with current plugins. Just notify stop/pause/play. diff --git a/doc/Display_Audio_Transition1.md b/doc/Display_Audio_Transition1.md index a9c1604..6a485a5 100644 --- a/doc/Display_Audio_Transition1.md +++ b/doc/Display_Audio_Transition1.md @@ -1,4 +1,5 @@ # Sound mode transition for single window application + diff --git a/doc/Display_Audio_Transition2.md b/doc/Display_Audio_Transition2.md index 8096aed..04d8115 100644 --- a/doc/Display_Audio_Transition2.md +++ b/doc/Display_Audio_Transition2.md @@ -1,4 +1,5 @@ # Sound mode transition for dual window application +
StateEvent
State IDDisplayAudioPowerPush HomeScreen buttonStart BTAIncoming callPush Shortcut buttonTTSPush Phone control buttonSafety hazard
-- cgit 1.2.3-korg
StateEvent
State IDDisplayAudioPowerPush HomeScreen buttonStart BTAIncoming callPush Shortcut buttonTouchTTSPush Phone control buttonSafety hazard