SDL_Android/SmartDeviceLinkAndroidProxy - added the correct version of the proxy
[profile/ivi/smartdevicelink.git] / SDL_Android / SmartDeviceLinkProxyAndroid / src / com / smartdevicelink / proxy / interfaces / IProxyListenerALM.java
index 64177ad..7ba574f 100755 (executable)
@@ -1,8 +1,48 @@
-//
-// Copyright (c) 2013 Ford Motor Company
-//
-package com.smartdevicelink.proxy.interfaces;
-
-public interface IProxyListenerALM extends IProxyListenerBase {
-
-}
+package com.smartdevicelink.proxy.interfaces;\r
+\r
+public interface IProxyListenerALM extends IProxyListenerBase {\r
+       // Adds Advanced Life-cycle Management call-backs to the IProxyListenerAbstract interface\r
+       \r
+       /**\r
+        * **MOVED TO IProxyListenerBase** - onOnHMIStatus() being called indicates that the proxy has entered a state in which the \r
+        * application may create SMARTDEVICELINK related resources (addCommands, ChoiceSets). \r
+        */\r
+       //public void onOnHMIStatus(OnHMIStatus notification);\r
+       \r
+       /**\r
+        * **MOVED TO IProxyListenerBase** - onProxyClosed() being called indicates that the app is no longer registered with SMARTDEVICELINK\r
+        * All resources on SMARTDEVICELINK (addCommands and ChoiceSets) have been deleted and will have to be\r
+        * recreated upon the next onReadyForInitialization() call-back. \r
+        */\r
+       //public void onProxyClosed(String info, Exception e);\r
+       \r
+       /**\r
+        * **MOVED TO IProxyListenerBase** - onError() being called indicates that the proxy has experienced an unrecoverable error.\r
+        * A new proxy object must be initiated to reestablish connection with SMARTDEVICELINK.\r
+        * \r
+        * @param info - Any info present about the error that occurred.\r
+        * @param e - Any exception thrown by the error.\r
+        */\r
+       //public void onError(String info, Exception e);\r
+       \r
+       /**\r
+        * **Deprecated** - onSmartDeviceLinkInterfaceAvailable() being called indicates that the proxy now has access to SMARTDEVICELINK's HMI. \r
+        * Monitor the onFocusChange call-back to determine which level of HMI is available to the proxy.\r
+        * \r
+        * @param isFirstAvailability - Indicates this is the first onSmartDeviceLinkInterfaceAvailable in this lifecycle.\r
+        */\r
+       // HMI (Background, Limited, Full) from Unavailable  = onSmartDeviceLinkInterfaceAvailable(Boolean isFirstAvailability);\r
+\r
+       /**\r
+        * **Deprecated** - onSmartDeviceLinkInterfaceUnavailable() being called indicates that the proxy does NOT have access to SMARTDEVICELINK's HIM.\r
+        */\r
+       // HMI None onSmartDeviceLinkInterfaceUnavailable();\r
+       \r
+       /**\r
+        * **Deprecated** - ALM HMI states converted back to HMI Levels\r
+        * \r
+        * HMI Full = onSmartDeviceLinkInFocus(Boolean isFirstSmartDeviceLinkInFocus);\r
+        * HMI Limited = onSmartDeviceLinkInFocusLimited();\r
+        * HMI Background = onSmartDeviceLinkLostFocus();\r
+        */\r
+}\r