Merge pull request #256 from smartdevicelink/release/8.0.0

SDL Core Release 8.0.0

Author: ShobhitAd

config.json

@@ -128,7 +128,10 @@
             },
             {
               "name": "OnAppCapabilityUpdated"
-            }
+            },
+            {
+              "name": "OnResetTimeout"
+            }            
           ]
         },
         {
@@ -144,7 +147,10 @@
               "name": "OnButtonPress"
             },
             {
-              "name": "OnButtonSubscription"
+              "name": "SubscribeButton"
+            },
+            {
+              "name": "UnsubscribeButton"
             },
             {
               "name": "ButtonPress"
@@ -281,9 +287,6 @@
             {
               "name": "OnLanguageChange"
             },
-            {
-              "name": "OnResetTimeout"
-            },
             {
               "name": "SetGlobalProperties"
             },
@@ -361,9 +364,6 @@
             {
               "name": "OnRecordStart"
             },
-            {
-              "name": "OnResetTimeout"
-            },
             {
               "name": "OnSubtleAlertPressed"
             },

docs/BasicCommunication/CloseApplication/index.md

@@ -11,17 +11,13 @@ Purpose
 
 ### Behavior
 
-If the application is in the foreground of the HMI:
 !!! must
 
-  1. Remove the application from the foreground.
+  1. Remove the application from the foreground (SDL will place the application in hmiLevel `NONE`).
+  2. Send `BC.OnResetTimeout` notification to SDL for resetting timeout in case HMI needs more time to process the request.
 
 !!!
 
-SDL will:
-
-1. Place the application in hmiLevel `NONE`
-
 ### Request
 
 #### Parameters

docs/BasicCommunication/DialNumber/index.md

@@ -22,10 +22,17 @@ SDL looks to see if the phone number entered is correct before passing to the HM
 !!! MUST
 
   1. Show DialNumber pop-up on HMI with 2 buttons, "Call" and "Cancel".
-  2. Send the notification OnAppDeactivated(PHONE_CALL) to SDL when the phone call is started on the HMI. The notification must be sent to all applications that have active audio sources on the HMI.
-  3. Send the notification BC.OnOnPhoneCall(isActive:true) to SDL when the phone call is started on the HMI.
+  2. Send the notification BC.OnOnPhoneCall(isActive:true) to SDL when the phone call is started on the HMI.
   3. Send the notification BC.OnOnPhoneCall(isActive:false) to SDL when the phone call is ended on the HMI.
-  4. Always respond to BC.DialNumber with a response code. If the HMI does not respond, the mobile application will never get a response from from SDL because default timeouts do not apply to the DialNumber mobile API.
+  4. Always respond to BC.DialNumber with a response code. If the HMI does not respond, the mobile application will never get a response from SDL because default timeouts do not apply to the DialNumber mobile API.
+  5. Send the notification `BC.OnResetTimeout` to SDL for resetting timeout in case HMI needs more time to process the `BC.DialNumber` request.
+
+!!!
+
+!!! MAY
+
+  1. Send the notification `BC.OnAppDeactivated` to SDL if the HMI leaves the app screen when the phone call is started.
+
 
 !!!
 

docs/BasicCommunication/GetSystemTime/index.md

@@ -15,7 +15,7 @@ In order to validate the certificate and to check whether this certificate is no
 ### Request
 
 SDL sends a GetSystemTime request after receiving a BC.OnSystemTimeReady notification from the HMI.  
-After sending the request SDL starts [`<DefaultTimeout>`](https://github.com/smartdevicelink/sdl_hmi_integration_guidelines/blob/develop/docs/Configuration%20file/index.md#main) (value from .ini file) waiting for response from HMI. 
+After sending the request SDL starts [`<DefaultTimeout>`](https://smartdevicelink.com/en/guides/core/getting-started/ini-configuration/) (value from .ini file) waiting for response from HMI. 
 
 #### Parameters
 

docs/BasicCommunication/OnAppUnregistered/index.md

@@ -17,7 +17,7 @@ SDL sends this notification when:
 
 !!! MUST
 
-  1. HMI must distinguish distinguish between an unexpected disconnect and a regular exit from the `unexpectedDisconnect` parameter.
+  1. HMI must distinguish between an unexpected disconnect and a regular exit from the `unexpectedDisconnect` parameter.
   2. HMI must removed the named application from the list of registered applications.
 
 !!!

docs/BasicCommunication/OnEventChanged/assets/PHONE_CALL1.png

@@ -18,21 +18,19 @@ SDL uses `OnEventChanged` notification to appropriately manage the hmiLevel and
 !!! MUST
 1. Send notification with appropriate parameter value when active call on HMI has been started/ended.
 
-2. Send [SDL.OnAppDeactivated](../../sdl/onappdeactivated) to the active app when the phone call is started.
-
-3. Resume the applications to their original state prior to the phone call event in the HMI when the event ends (see note below).
+2. Return the applications to their appropriate audio streaming state in the HMI when the event ends.
 !!!
 
 !!! NOTE
-SDL does not send BC.ActivateApp or BC.OnResumeAudioSource to HMI after the phone call is ended.
+If the HMI wants to leave the app screen when the PHONE_CALL event occurs, the app's HMI state can be changed accordingly using the `BC.OnAppDeactivated(appID)` and `BC.OnAppActivated(appID)` notifications.
 !!!
 
 Upon receiving `OnEventChanged(PHONE_CALL)`, SDL will:
 
 |isActive|Result|
 |:-------|:-----|
-|true|Change the HMI state of all media applications currently either in FULL or LIMITED to (BACKGROUND, NOT_AUDIBLE) and all navi/projection apps to (LIMITED, NOT_AUDIBLE, STREAMABLE)|
-|false|Return applications to the same HMI state they had prior to the event|
+|true|Move all apps with audioStreamingState AUDIBLE to NOT_AUDIBLE|
+|false|Remove all HMI state modifications that were applied during the event from each application|
 
 #### EMERGENCY_EVENT
 
@@ -47,7 +45,7 @@ Upon receiving `OnEventChanged(EMERGENCY_EVENT)`, SDL will:
 |isActive|Result|
 |:-------|:-----|
 |true|Move all apps with audioStreamingState AUDIBLE or STREAMABLE to NOT_AUDIBLE and NOT_STREAMABLE|
-|false|Return applications to the same HMI state they had prior to the event|
+|false|Remove all HMI state modifications that were applied during the event from each application|
 
 !!! NOTE
 While the event is active, the app is not allowed to stream audio and it will not be heard by the user (due to other audio and/or system events blocking it).
@@ -65,7 +63,7 @@ Upon receiving `OnEventChanged(DEACTIVATE_HMI)`, SDL will:
 |isActive|Result|
 |:-------|:-----|
 |true|Change the hmiLevel of all applications currently in (FULL/LIMITED) to (BACKGROUND, NOT_AUDIBLE, NOT_STREAMABLE)|
-|false|Return applications to the same HMI state they had prior to the event|
+|false|Remove all HMI state modifications that were applied during the event from each application|
 
 !!! NOTE
 When this event is active, SDL **rejects** all app activation requests from the HMI.
@@ -81,7 +79,7 @@ When this event is active, SDL **rejects** all app activation requests from the
     - The HMI must deactivate the EMBEDDED_NAVI event if a navigation app is activated.
 4. When the system supports audio mixing and embedded navigation starts streaming
     - Send TTS.Started to SDL to change media app currently in (LIMITED, AUDIBLE) to (LIMITED, ATTENUATED) due to active embedded navigation.
-    - Send TTS.Stopped to SDL right after embedded navigation stops streaming to change application's HMIStatus to the same state it had prior to the event.
+    - Send TTS.Stopped to SDL right after embedded navigation stops streaming to remove any HMI state modifications that were applied during the event.
 !!!
 
 !!! NOTE
@@ -200,4 +198,4 @@ Multiple apps activation during active embedded navigation or audio source
   }
 
 }
-```
+```

docs/BasicCommunication/OnEventChanged/assets/PHONE_CALL2.png

@@ -0,0 +1,22 @@
+participant App
+participant SDL
+participant HMI
+
+note over App,HMI:<align:center> **//Pre-conditions://** 1. appID is active on HMI
+
+App->SDL: Alert(params)
+SDL->HMI: UI.Alert(params)
+
+note over HMI:<align:center>Display the Alert dialog with\nalertText1 text and a\nsoftButtonID_1 soft button
+
+HMI->>SDL:UI.OnSystemContext(ALERT)
+
+note over HMI:<align:center>User taps the\nsoftButtonID_1 button
+
+HMI->>SDL: Buttons.OnButtonEvent(BUTTONDOWN, customButtonID_1)
+HMI->SDL: BC.OnResetTimeout(resetPeriod)
+
+note over App,HMI:<align:center>Timeout for UI.Alert(softButtons) never expires\nSDL does not apply UI.Alert timeout\nSDL does not reset timeout by BC.OnResetTimeout
+
+HMI-->SDL: UI.Alert(SUCCESS)
+SDL-->App: Alert(SUCCESS)