summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKazumasa Mitsunari <knimitz@witz-inc.co.jp>2017-12-11 11:40:48 +0900
committerKazumasa Mitsunari <knimitz@witz-inc.co.jp>2017-12-22 21:01:11 +0900
commit0d622cf082863e041e88da568c7ef6d0500f847d (patch)
tree2f68be6830e4d8a5e9b30f6a33da005d820808ad
parent2132cff7c32e26808386ab61809d4abb85fae632 (diff)
Update ApplicationGuide document
Change-Id: Iddd44a39af92aa79f027ae7e1e866fbc9df18966 Signed-off-by: Kazumasa Mitsunari <knimitz@witz-inc.co.jp>
-rw-r--r--doc/ApplicationGuide.md36
1 files changed, 16 insertions, 20 deletions
diff --git a/doc/ApplicationGuide.md b/doc/ApplicationGuide.md
index 1a1e501..c84dd00 100644
--- a/doc/ApplicationGuide.md
+++ b/doc/ApplicationGuide.md
@@ -1,9 +1,9 @@
# **Sound Manager Application Guide**
-<div align="right">Revision: 0.2Final</div>
+<div align="right">Revision: 0.3alpha</div>
<div align="right">TOYOTA MOTOR CORPORATION</div>
<div align="right">Advanced Driver Information Technology</div>
-<div align="right">23rd/Oct/2017</div>
+<div align="right">11th/Dec/2017</div>
* * *
@@ -251,9 +251,7 @@ For understanding, GENIVI Audio Manager stands for one core module and three plu
- connect(int sourceID, const std::string& sinkName)
- disconnect(int connectionID)
- ackSetSourceState(int handle, int err)
-- set_event_handler(enum EventType_SM et, handler_asyncSetSourceState f)
-- register_callback( void (*event_cb)(const std::string& event, struct json_object* event_contents), void (*reply_cb)(struct json_object* reply_contents), void (*hangup_cb)(void) = nullptr)
-- register_callback( void (*reply_cb)(struct json_object* reply_contents), void (*hangup_cb)(void) = nullptr) (overload)
+- registerCallback( void (*event_cb)(const std::string& event, struct json_object* event_contents), void (*reply_cb)(struct json_object* reply_contents), void (*hangup_cb)(void) = nullptr)
Regarding more detail, please refer doxygen documents.
@@ -262,28 +260,26 @@ Regarding more detail, please refer doxygen documents.
### Events
"libsoundmanager" provides the feature which receives the events which an app subscribes with "subscribe" API.
-An application can get events to register a callback function with "register_callback" API.
+An application can get events to register a callback function with "registerCallback" API.
-or you can use "set_event_handler" API to designate the event enumlation.
+And this event is subscribed automatically. (See below Note)
-- Event_AsyncSetSourceState
+- asyncSetSourceState
-The below events will be available at final version.
+The below events are available but not mandatory.
-- Event_NewMainConnection
-- Event_RemovedMainConnection
-- Event_MainConnectionStateChanged
-- Event_VolumeChanged
-- Event_SinkMuteStateChanged
-- Event_setRoutingReady
-- Event_asyncConnect
-- Event_asyncDisconnect
-
-But these events are not necessary.
+- newMainConnection
+- removedMainConnection
+- mainConnectionStateChanged
+- volumeChanged
+- sinkMuteStateChanged
+- setRoutingReady
+- asyncConnect
+- asyncDisconnect
Note:
-"asyncSetSourceState" is always subscribed in init phase because this is the most important event for audio policy management.
+"asyncSetSourceState" is always subscribed in init phase because this is the most important event for audio policy management. This event indicates the approval/disapproval/pause.
Regarding more detail, please refer doxygen documents.