SPEC-1924: AGL Speech Framework's Voice Service High Level 1.0 Release.

Details:
1) Control plugin implementation for VSHL 1.0
2) Exposed APIs that are documented in the confluence page
   https://confluence.automotivelinux.org/display/SPE/Speech+EG+Architecture
3) Implemented 39 unit tests based on GTest framework to test all the low
level components of VSHL binding.
4) Implemented a HTML5 based VSHL API tester application to test VSHL APIs.

API specification:
https://confluence.automotivelinux.org/display/SPE/Speech+EG+Architecture#SpeechEGArchitecture-HighLevelVoiceService

Test performed:
1) Tested AGL service running Alexa Auto SDK https://github.com/alexa/aac-sdk on Ubuntu 16.04 and Renesas R-Car M3 board.

License:
Apache 2.0

Developers/Owners:
Naveen Bobbili (nbobbili@amazon.com)
Prakash Buddhiraja (buddhip@amazon.com)
Shotaro Uchida (shotaru@amazon.co.jp)

Change-Id: I3370f4ad65aff030f24f4ad571fb02d525bbfbca
Signed-off-by: Naveen Bobbili  <nbobbili@amazon.com>

2 files changed, 314 insertions, 0 deletions

diff --git a/src/plugins/core/test/VRRequestProcessorTest.cpp b/src/plugins/core/test/VRRequestProcessorTest.cpp
new file mode 100644
index 0000000..c1a37df
--- /dev/null
+++ b/src/plugins/core/test/VRRequestProcessorTest.cpp
@@ -0,0 +1,213 @@
+/*
+ * Copyright 2018-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ *
+ *     http://aws.amazon.com/apache2.0/
+ *
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+#include <gtest/gtest.h>
+
+#include "core/VRRequestProcessor.h"
+#include "voiceagents/include/VoiceAgent.h"
+#include "voiceagents/test/VoiceAgentsTestData.h"
+
+#include "test/common/ConsoleLogger.h"
+#include "test/mocks/AFBApiMock.h"
+
+using namespace vshl::core;
+using namespace vshl::voiceagents;
+using namespace vshl::test::common;
+
+namespace vshl {
+namespace test {
+
+class VRRequestProcessorTest : public ::testing::Test {
+protected:
+    void SetUp() override {
+        mConsoleLogger = std::make_shared<ConsoleLogger>();
+        mAfbApi = std::make_shared<::testing::StrictMock<AFBApiMock>>();
+
+        auto vaTestData = *(getVoiceAgentsTestData().begin());
+        mVoiceAgent = VoiceAgent::create(
+            mConsoleLogger,
+            vaTestData.id,
+            vaTestData.name,
+            vaTestData.description,
+            vaTestData.api,
+            vaTestData.vendor,
+            vaTestData.activeWakeword,
+            vaTestData.isActive,
+            vaTestData.wakewords);
+
+        mVRReqProcessorDelegate = VRRequestProcessorDelegate::create(mConsoleLogger, mAfbApi);
+        mVRRequestProcessor = VRRequestProcessor::create(mConsoleLogger, mVRReqProcessorDelegate);
+    }
+
+    std::shared_ptr<::testing::StrictMock<AFBApiMock>> mAfbApi;
+    std::shared_ptr<ConsoleLogger> mConsoleLogger;
+    std::shared_ptr<VoiceAgent> mVoiceAgent;
+
+    std::shared_ptr<VRRequestProcessorDelegate> mVRReqProcessorDelegate;
+    std::shared_ptr<VRRequestProcessor> mVRRequestProcessor;
+};
+
+TEST_F(VRRequestProcessorTest, initializesCorrectly) {
+    ASSERT_NE(mVRRequestProcessor, nullptr);
+}
+
+TEST_F(VRRequestProcessorTest, startListeningFailsOnLackOfDefaultAgent) {
+    auto requestId = mVRRequestProcessor->startListening();
+    ASSERT_EQ(requestId, "");
+}
+
+TEST_F(VRRequestProcessorTest, startListeningAndCancelWorks) {
+    mVRReqProcessorDelegate->setDefaultVoiceAgent(mVoiceAgent);
+
+    {
+        ::testing::InSequence dummy;
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_STARTLISTENING,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_CANCEL,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+    }
+
+    mVRRequestProcessor->startListening();
+    auto requests = mVRReqProcessorDelegate->getAllRequests();
+    ASSERT_EQ(requests.size(), 1);
+
+    mVRRequestProcessor->cancel();
+    requests = mVRReqProcessorDelegate->getAllRequests();
+    ASSERT_EQ(requests.size(), 0);
+}
+
+TEST_F(VRRequestProcessorTest, requestIsCancelledOnObjectDestruction) {
+    auto delegate = VRRequestProcessorDelegate::create(mConsoleLogger, mAfbApi);
+    auto processor = VRRequestProcessor::create(mConsoleLogger, delegate);
+
+    delegate->setDefaultVoiceAgent(mVoiceAgent);
+
+    {
+        ::testing::InSequence dummy;
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_STARTLISTENING,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_CANCEL,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+    }
+
+    auto requestId = processor->startListening();
+    ASSERT_NE(requestId, "");
+
+    auto requests = delegate->getAllRequests();
+    ASSERT_EQ(requests.size(), 1);
+}
+
+TEST_F(VRRequestProcessorTest, backToBackStartListeningCancelsEarlierRequest) {
+    mVRReqProcessorDelegate->setDefaultVoiceAgent(mVoiceAgent);
+
+    {
+        ::testing::InSequence dummy;
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_STARTLISTENING,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_CANCEL,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_STARTLISTENING,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+
+        EXPECT_CALL(
+            *mAfbApi,
+            callSync(
+                mVoiceAgent->getApi(),
+                VRRequest::VA_VERB_CANCEL,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_,
+                ::testing::_))
+            .Times(1);
+    }
+
+    mVRRequestProcessor->startListening();
+    auto requests = mVRReqProcessorDelegate->getAllRequests();
+    ASSERT_EQ(requests.size(), 1);
+
+    mVRRequestProcessor->startListening();
+    requests = mVRReqProcessorDelegate->getAllRequests();
+    ASSERT_EQ(requests.size(), 1);
+
+    mVRRequestProcessor->cancel();
+    requests = mVRReqProcessorDelegate->getAllRequests();
+    ASSERT_EQ(requests.size(), 0);
+}
+
+}  // namespace test
+}  // namespace vshl
\ No newline at end of file
diff --git a/src/plugins/core/test/VRRequestTest.cpp b/src/plugins/core/test/VRRequestTest.cpp
new file mode 100644
index 0000000..b1cd0a6
--- /dev/null
+++ b/src/plugins/core/test/VRRequestTest.cpp
@@ -0,0 +1,101 @@
+/*
+ * Copyright 2018-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * A copy of the License is located at
+ *
+ *     http://aws.amazon.com/apache2.0/
+ *
+ * or in the "license" file accompanying this file. This file is distributed
+ * on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
+ * express or implied. See the License for the specific language governing
+ * permissions and limitations under the License.
+ */
+
+#include <gtest/gtest.h>
+
+#include "core/include/VRRequest.h"
+#include "voiceagents/include/VoiceAgent.h"
+#include "voiceagents/test/VoiceAgentsTestData.h"
+
+#include "test/common/ConsoleLogger.h"
+#include "test/mocks/AFBApiMock.h"
+
+using namespace vshl::core;
+using namespace vshl::voiceagents;
+using namespace vshl::test::common;
+
+namespace vshl {
+namespace test {
+
+class VRRequestTest : public ::testing::Test {
+protected:
+    void SetUp() override {
+        mRequestId = "Req-0001";
+
+        mConsoleLogger = std::make_shared<ConsoleLogger>();
+        mAfbApi = std::make_shared<::testing::StrictMock<AFBApiMock>>();
+
+        auto vaTestData = *(getVoiceAgentsTestData().begin());
+        mVoiceAgent = VoiceAgent::create(
+            mConsoleLogger,
+            vaTestData.id,
+            vaTestData.name,
+            vaTestData.description,
+            vaTestData.api,
+            vaTestData.vendor,
+            vaTestData.activeWakeword,
+            vaTestData.isActive,
+            vaTestData.wakewords);
+
+        mVRRequest = VRRequest::create(mConsoleLogger, mAfbApi, mRequestId, mVoiceAgent);
+    }
+
+    std::string mRequestId;
+    std::shared_ptr<::testing::StrictMock<AFBApiMock>> mAfbApi;
+    std::shared_ptr<ConsoleLogger> mConsoleLogger;
+    std::shared_ptr<VoiceAgent> mVoiceAgent;
+
+    std::shared_ptr<VRRequest> mVRRequest;
+};
+
+TEST_F(VRRequestTest, initializesCorrectly) {
+    ASSERT_NE(mVRRequest, nullptr);
+}
+
+TEST_F(VRRequestTest, failsCreationOnInvalidParams) {
+    auto vrRequest = VRRequest::create(mConsoleLogger, nullptr, mRequestId, mVoiceAgent);
+    ASSERT_EQ(vrRequest, nullptr);
+
+    vrRequest = VRRequest::create(nullptr, mAfbApi, mRequestId, mVoiceAgent);
+    ASSERT_EQ(vrRequest, nullptr);
+}
+
+TEST_F(VRRequestTest, startsListeningSuccessfully) {
+    EXPECT_CALL(
+        *mAfbApi,
+        callSync(
+            mVoiceAgent->getApi(),
+            VRRequest::VA_VERB_STARTLISTENING,
+            ::testing::_,
+            ::testing::_,
+            ::testing::_,
+            ::testing::_))
+        .Times(1);
+
+    ASSERT_TRUE(mVRRequest->startListening());
+}
+
+TEST_F(VRRequestTest, cancelsSuccessfully) {
+    EXPECT_CALL(
+        *mAfbApi,
+        callSync(
+            mVoiceAgent->getApi(), VRRequest::VA_VERB_CANCEL, ::testing::_, ::testing::_, ::testing::_, ::testing::_))
+        .Times(1);
+
+    ASSERT_TRUE(mVRRequest->cancel());
+}
+
+}  // namespace test
+}  // namespace vshl
\ No newline at end of file