From ecb08f3cffd0b6e1737eb9c9de2d81dd1bf697f9 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Wed, 20 Sep 2023 11:15:59 +0800
Subject: [PATCH 01/12] disable auto kill in non temi environment

---
 .../robotemi/sdk/TemiSdkServiceConnection.kt  | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt b/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt
index 4d59de97..f6c389b1 100644
--- a/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt
@@ -5,6 +5,7 @@ import android.content.ComponentName
 import android.content.Context
 import android.content.Intent
 import android.content.ServiceConnection
+import android.content.pm.PackageManager
 import android.os.IBinder
 import android.os.Process
 import android.util.Log
@@ -27,6 +28,9 @@ internal class TemiSdkServiceConnection {
         }
     }
 
+    @Volatile
+    private var isLauncherExist = false
+
     @NonNull
     private val serviceConnection = object : ServiceConnection {
 
@@ -48,6 +52,8 @@ internal class TemiSdkServiceConnection {
     @UiThread
     internal fun startConnection(context: Context) {
         Log.d(TAG, "startConnection(Context)")
+        isLauncherExist = isPackageExist(context, SdkConstants.TEMI_USA) ||
+                isPackageExist(context, SdkConstants.TEMI_CHINA)
         when {
             context.bindService(
                 getSdkServiceIntent(SdkConstants.TEMI_USA),
@@ -73,6 +79,17 @@ internal class TemiSdkServiceConnection {
     @SuppressLint("LongLogTag")
     private fun forceStop() {
         Log.d(TAG, "forceStop()")
-        Process.killProcess(Process.myPid())
+        if (isLauncherExist)
+            Process.killProcess(Process.myPid())
+    }
+
+    private fun isPackageExist(context: Context, targetPackage: String): Boolean {
+        val pm: PackageManager = context.packageManager
+        try {
+            val info = pm.getPackageInfo(targetPackage, PackageManager.GET_META_DATA)
+        } catch (e: PackageManager.NameNotFoundException) {
+            return false
+        }
+        return true
     }
 }

From bc4c7d86a9efd9295337e67c9222076faeb639e1 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Mon, 25 Sep 2023 16:34:36 +0800
Subject: [PATCH 02/12] add startPage() tour page support, getAllTours()and
 playTour()

---
 .../com/robotemi/sdk/sample/MainActivity.kt   | 40 +++++++++++++
 .../src/main/res/layout/group_resources.xml   | 10 ++++
 .../aidl/com/robotemi/sdk/ISdkService.aidl    |  5 ++
 .../com/robotemi/sdk/tourguide/TourModel.aidl |  4 ++
 sdk/src/main/java/com/robotemi/sdk/Robot.kt   | 38 ++++++++++++
 .../robotemi/sdk/constants/SdkConstants.kt    |  5 +-
 .../com/robotemi/sdk/tourguide/TourModel.kt   | 58 +++++++++++++++++++
 7 files changed, 159 insertions(+), 1 deletion(-)
 create mode 100644 sdk/src/main/aidl/com/robotemi/sdk/tourguide/TourModel.aidl
 create mode 100644 sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt

diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index d11d1864..4f886a96 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -68,6 +68,7 @@ import com.robotemi.sdk.sequence.SequenceModel
 import com.robotemi.sdk.telepresence.CallState
 import com.robotemi.sdk.telepresence.LinkBasedMeeting
 import com.robotemi.sdk.telepresence.Participant
+import com.robotemi.sdk.tourguide.TourModel
 import com.robotemi.sdk.voice.ITtsService
 import com.robotemi.sdk.voice.model.TtsVoice
 import kotlinx.android.synthetic.main.activity_main.*
@@ -393,7 +394,9 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         btnRequestToBeKioskApp.setOnClickListener { requestToBeKioskApp() }
         btnStartDetectionModeWithDistance.setOnClickListener { startDetectionWithDistance() }
         btnFetchSequence.setOnClickListener { getAllSequences() }
+        btnFetchTour.setOnClickListener { getAllTours() }
         btnPlayFirstSequence.setOnClickListener { playFirstSequence() }
+        btnPlayFirstTour.setOnClickListener { playFirstTour() }
         btnPlayFirstSequenceWithoutPlayer.setOnClickListener { playFirstSequenceWithoutPlayer() }
         btnFetchMap.setOnClickListener { getMap() }
         btnClearLog.setOnClickListener { clearLog() }
@@ -1633,6 +1636,43 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         }
     }
 
+    @Volatile
+    private var allTours: List<TourModel> = emptyList()
+
+    private fun getAllTours() {
+        if (requestPermissionIfNeeded(Permission.SEQUENCE, REQUEST_CODE_SEQUENCE_FETCH_ALL)) {
+            return
+        }
+        Thread {
+            allTours = robot.getAllTours()
+            printLog("allTours: ${allTours.size}", false)
+            val imageKeys: MutableList<String> = ArrayList()
+            for ((_, _, _, _, imageKey) in allTours) {
+                if (imageKey.isEmpty()) continue
+                imageKeys.add(imageKey)
+            }
+            val pairs = if (imageKeys.isEmpty()) emptyList()
+            else robot.getSignedUrlByMediaKey(imageKeys)
+            runOnUiThread {
+                for (tourGuide in allTours) {
+                    printLog(tourGuide.toString())
+                }
+                for (pair in pairs) {
+                    printLog(pair.component2(), false)
+                }
+            }
+        }.start()
+    }
+
+    private fun playFirstTour() {
+        if (requestPermissionIfNeeded(Permission.SEQUENCE, REQUEST_CODE_SEQUENCE_PLAY)) {
+            return
+        }
+        if (!allTours.isNullOrEmpty()) {
+            robot.playTour(allTours[0].id)
+        }
+    }
+
     private fun getMap() {
         if (requestPermissionIfNeeded(Permission.MAP, REQUEST_CODE_MAP)) {
             return
diff --git a/sample/src/main/res/layout/group_resources.xml b/sample/src/main/res/layout/group_resources.xml
index ba2b6a58..a1629cad 100644
--- a/sample/src/main/res/layout/group_resources.xml
+++ b/sample/src/main/res/layout/group_resources.xml
@@ -42,6 +42,11 @@
         style="@style/ButtonCommon"
         android:text="Get All Sequences" />
 
+    <Button
+        android:id="@+id/btnFetchTour"
+        style="@style/ButtonCommon"
+        android:text="Get All Tours" />
+
     <Button
         android:id="@+id/btnPlayFirstSequenceWithoutPlayer"
         style="@style/ButtonCommon"
@@ -52,6 +57,11 @@
         style="@style/ButtonCommon"
         android:text="Play First Sequence" />
 
+    <Button
+        android:id="@+id/btnPlayFirstTour"
+        style="@style/ButtonCommon"
+        android:text="Play First Tour" />
+
     <Button
         android:id="@+id/btnGetOSVersion"
         style="@style/ButtonCommon"
diff --git a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
index 670b66f9..b9652007 100644
--- a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
+++ b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
@@ -14,6 +14,7 @@ import com.robotemi.sdk.model.RecentCallModel;
 import com.robotemi.sdk.BatteryData;
 import com.robotemi.sdk.sequence.SequenceModel;
 import com.robotemi.sdk.telepresence.Participant;
+import com.robotemi.sdk.tourguide.TourModel;
 import com.robotemi.sdk.navigation.model.Position;
 import com.robotemi.sdk.map.MapDataModel;
 import com.robotemi.sdk.model.MemberStatusModel;
@@ -361,4 +362,8 @@ interface ISdkService {
     String startMeeting(in String packageName, in List<Participant> participants, boolean firstParticipantJoinedAsHost);
 
     int configMinimumObstacleDistance(in String packageName, int value);
+
+    List<TourModel> getAllTours(in String packageName);
+
+    void playTour(in String packageName, in String tourId);
 }
\ No newline at end of file
diff --git a/sdk/src/main/aidl/com/robotemi/sdk/tourguide/TourModel.aidl b/sdk/src/main/aidl/com/robotemi/sdk/tourguide/TourModel.aidl
new file mode 100644
index 00000000..1b711b5d
--- /dev/null
+++ b/sdk/src/main/aidl/com/robotemi/sdk/tourguide/TourModel.aidl
@@ -0,0 +1,4 @@
+// TourModel.aidl
+package com.robotemi.sdk.tourguide;
+
+parcelable TourModel;
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index 7aa86a6a..084b054a 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -58,6 +58,8 @@ import com.robotemi.sdk.sequence.compatible
 import com.robotemi.sdk.telepresence.CallState
 import com.robotemi.sdk.telepresence.LinkBasedMeeting
 import com.robotemi.sdk.telepresence.Participant
+import com.robotemi.sdk.tourguide.TourModel
+import com.robotemi.sdk.tourguide.compatible
 import com.robotemi.sdk.voice.ITtsService
 import com.robotemi.sdk.voice.model.TtsVoice
 import org.json.JSONException
@@ -2863,6 +2865,42 @@ class Robot private constructor(private val context: Context) {
         }
     }
 
+    /*****************************************/
+    /*                  Tour                 */
+    /*****************************************/
+
+    /**
+     * Fetch all tours user created on the Web platform.
+     *
+     * @return List holds all tours.
+     */
+    @WorkerThread
+    @CheckResult
+    @JvmOverloads
+    fun getAllTours(): List<TourModel> {
+        return try {
+            (sdkService?.getAllTours(applicationInfo.packageName)
+                ?: emptyList<TourModel>()).map { it.compatible() }
+        } catch (e: RemoteException) {
+            Log.e(TAG, "getAllTours() error")
+            emptyList()
+        }
+    }
+
+    /**
+     * Play tour by tour ID.
+     *
+     * @param tourId Tour ID you want to play.
+     */
+    @JvmOverloads
+    fun playTour(tourId: String) {
+        try {
+            sdkService?.playTour(applicationInfo.packageName, tourId)
+        } catch (e: RemoteException) {
+            Log.e(TAG, "playTour() error")
+        }
+    }
+
     @UiThread
     fun addOnSequencePlayStatusChangedListener(listener: OnSequencePlayStatusChangedListener) {
         onSequencePlayStatusChangedListeners.add(listener)
diff --git a/sdk/src/main/java/com/robotemi/sdk/constants/SdkConstants.kt b/sdk/src/main/java/com/robotemi/sdk/constants/SdkConstants.kt
index 50d04fcf..5d7d8b45 100644
--- a/sdk/src/main/java/com/robotemi/sdk/constants/SdkConstants.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/constants/SdkConstants.kt
@@ -6,6 +6,7 @@ import com.robotemi.sdk.constants.SdkConstants.PAGE_HOME
 import com.robotemi.sdk.constants.SdkConstants.PAGE_LOCATIONS
 import com.robotemi.sdk.constants.SdkConstants.PAGE_MAP_EDITOR
 import com.robotemi.sdk.constants.SdkConstants.PAGE_SETTINGS
+import com.robotemi.sdk.constants.SdkConstants.PAGE_TOURS
 
 object SdkConstants {
     // metadata key
@@ -90,6 +91,7 @@ object SdkConstants {
     const val PAGE_LOCATIONS = "com.robotemi.page.locations"
     const val PAGE_ALL_APPS = "com.robotemi.page.all_apps"
     const val PAGE_HOME = "com.robotemi.page.home"
+    const val PAGE_TOURS = "com.robotemi.page.tours"
 
     const val INTENT_ACTION_GREET_MODE_STATE = "greet_mode_state"
 
@@ -117,7 +119,8 @@ enum class Page(val value: String) {
     CONTACTS(PAGE_CONTACTS),
     LOCATIONS(PAGE_LOCATIONS),
     ALL_APPS(PAGE_ALL_APPS),
-    HOME(PAGE_HOME)
+    HOME(PAGE_HOME),
+    TOURS(PAGE_TOURS)
 }
 
 enum class SoundMode(val value: Int) {
diff --git a/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt b/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt
new file mode 100644
index 00000000..515a5483
--- /dev/null
+++ b/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt
@@ -0,0 +1,58 @@
+package com.robotemi.sdk.tourguide
+
+import android.os.Parcel
+import android.os.Parcelable
+
+data class TourModel @JvmOverloads constructor(
+    val id: String,
+    val name: String,
+    val language: String,
+    val description: String,
+    val imageKey: String = "",
+    val tags: List<String> = emptyList(),
+    val extras: String = ""
+) : Parcelable {
+    constructor(parcel: Parcel) : this(
+        parcel.readString()!!,
+        parcel.readString()!!,
+        parcel.readString()!!,
+        parcel.readString()!!,
+        parcel.readString()!!,
+        mutableListOf<String>().apply {
+            parcel.readList(this, String::class.java.classLoader)
+        },
+        parcel.readString()!!
+    )
+
+    override fun writeToParcel(parcel: Parcel, flags: Int) {
+        parcel.writeString(id)
+        parcel.writeString(name)
+        parcel.writeString(language)
+        parcel.writeString(description)
+        parcel.writeString(imageKey)
+        parcel.writeList(tags)
+        parcel.writeString(extras)
+    }
+
+    override fun describeContents(): Int {
+        return 0
+    }
+
+    companion object {
+        @JvmField
+        val CREATOR: Parcelable.Creator<TourModel> =
+            object : Parcelable.Creator<TourModel> {
+                override fun createFromParcel(parcel: Parcel): TourModel {
+                    return TourModel(parcel)
+                }
+
+                override fun newArray(size: Int): Array<TourModel?> {
+                    return arrayOfNulls(size)
+                }
+            }
+    }
+}
+
+internal fun TourModel.compatible(): TourModel {
+    return this
+}
\ No newline at end of file

From d1e76bfaf11d6e76b7f11b42d3a97ed723280259 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Mon, 25 Sep 2023 17:53:58 +0800
Subject: [PATCH 03/12] get minimal packageInfo for checking launcher existence

---
 .../main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt   | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt b/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt
index f6c389b1..0f25e6b7 100644
--- a/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/TemiSdkServiceConnection.kt
@@ -79,14 +79,15 @@ internal class TemiSdkServiceConnection {
     @SuppressLint("LongLogTag")
     private fun forceStop() {
         Log.d(TAG, "forceStop()")
-        if (isLauncherExist)
+        if (isLauncherExist) {
             Process.killProcess(Process.myPid())
+        }
     }
 
     private fun isPackageExist(context: Context, targetPackage: String): Boolean {
         val pm: PackageManager = context.packageManager
         try {
-            val info = pm.getPackageInfo(targetPackage, PackageManager.GET_META_DATA)
+            pm.getPackageInfo(targetPackage, 0)
         } catch (e: PackageManager.NameNotFoundException) {
             return false
         }

From 086cf4c878f2d6e895ae70eac6e1a697260b0dc5 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Tue, 10 Oct 2023 09:59:11 +0800
Subject: [PATCH 04/12] include response code in playTour

---
 gradle.properties                             |  2 +-
 .../com/robotemi/sdk/sample/MainActivity.kt   | 22 +++++++------------
 .../aidl/com/robotemi/sdk/ISdkService.aidl    |  2 +-
 sdk/src/main/java/com/robotemi/sdk/Robot.kt   | 10 ++++-----
 .../com/robotemi/sdk/tourguide/TourModel.kt   |  2 +-
 5 files changed, 16 insertions(+), 22 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index a763264d..513dec91 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -21,7 +21,7 @@ android.enableJetifier=true
 kotlin.code.style=official
 
 GROUP=com.robotemi
-VERSION_NAME=1.131.4
+VERSION_NAME=1.132.0.1-SNAPSHOT
 POM_URL=https://github.com/robotemi/sdk/
 POM_SCM_URL=https://github.com/robotemi/sdk/
 POM_SCM_CONNECTION=scm:git:git://github.com/robotemi/sdk.git
diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index 4f886a96..76e24674 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -1599,8 +1599,11 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
                 if (imageKey.isEmpty()) continue
                 imageKeys.add(imageKey)
             }
-            val pairs = if (imageKeys.isEmpty()) emptyList()
-            else robot.getSignedUrlByMediaKey(imageKeys)
+            val pairs = if (imageKeys.isEmpty()) {
+                emptyList()
+            } else {
+                robot.getSignedUrlByMediaKey(imageKeys)
+            }
             runOnUiThread {
                 for (sequenceModel in allSequences) {
                     printLog(sequenceModel.toString())
@@ -1646,20 +1649,10 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         Thread {
             allTours = robot.getAllTours()
             printLog("allTours: ${allTours.size}", false)
-            val imageKeys: MutableList<String> = ArrayList()
-            for ((_, _, _, _, imageKey) in allTours) {
-                if (imageKey.isEmpty()) continue
-                imageKeys.add(imageKey)
-            }
-            val pairs = if (imageKeys.isEmpty()) emptyList()
-            else robot.getSignedUrlByMediaKey(imageKeys)
             runOnUiThread {
                 for (tourGuide in allTours) {
                     printLog(tourGuide.toString())
                 }
-                for (pair in pairs) {
-                    printLog(pair.component2(), false)
-                }
             }
         }.start()
     }
@@ -1668,8 +1661,9 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         if (requestPermissionIfNeeded(Permission.SEQUENCE, REQUEST_CODE_SEQUENCE_PLAY)) {
             return
         }
-        if (!allTours.isNullOrEmpty()) {
-            robot.playTour(allTours[0].id)
+        if (allTours.isNotEmpty()) {
+            val ret = robot.playTour(allTours[0].id)
+            printLog("playTour: $ret")
         }
     }
 
diff --git a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
index b9652007..ba5efb9c 100644
--- a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
+++ b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
@@ -365,5 +365,5 @@ interface ISdkService {
 
     List<TourModel> getAllTours(in String packageName);
 
-    void playTour(in String packageName, in String tourId);
+    int playTour(in String packageName, in String tourId);
 }
\ No newline at end of file
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index 084b054a..92105003 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -2870,7 +2870,7 @@ class Robot private constructor(private val context: Context) {
     /*****************************************/
 
     /**
-     * Fetch all tours user created on the Web platform.
+     * Fetch all tours user created on the Web platform. Require [Permission.SEQUENCE]
      *
      * @return List holds all tours.
      */
@@ -2888,16 +2888,16 @@ class Robot private constructor(private val context: Context) {
     }
 
     /**
-     * Play tour by tour ID.
+     * Play tour by tour ID. Require [Permission.SEQUENCE]
      *
      * @param tourId Tour ID you want to play.
      */
-    @JvmOverloads
-    fun playTour(tourId: String) {
+    fun playTour(tourId: String): Int {
         try {
-            sdkService?.playTour(applicationInfo.packageName, tourId)
+            return sdkService?.playTour(applicationInfo.packageName, tourId) ?: -1
         } catch (e: RemoteException) {
             Log.e(TAG, "playTour() error")
+            return -1
         }
     }
 
diff --git a/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt b/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt
index 515a5483..72e8dd48 100644
--- a/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/tourguide/TourModel.kt
@@ -10,7 +10,7 @@ data class TourModel @JvmOverloads constructor(
     val description: String,
     val imageKey: String = "",
     val tags: List<String> = emptyList(),
-    val extras: String = ""
+    private val extras: String = ""
 ) : Parcelable {
     constructor(parcel: Parcel) : this(
         parcel.readString()!!,

From 434a215d97cf9f0eb0a08f791839c4e4528f7469 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Tue, 10 Oct 2023 11:34:01 +0800
Subject: [PATCH 05/12] include getAllTours with tags

---
 sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl | 2 +-
 sdk/src/main/java/com/robotemi/sdk/Robot.kt         | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
index ba5efb9c..5e6b2ea2 100644
--- a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
+++ b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
@@ -363,7 +363,7 @@ interface ISdkService {
 
     int configMinimumObstacleDistance(in String packageName, int value);
 
-    List<TourModel> getAllTours(in String packageName);
+    List<TourModel> getAllTours(in String packageName, in List<String> tags);
 
     int playTour(in String packageName, in String tourId);
 }
\ No newline at end of file
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index 92105003..08137e7f 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -2877,9 +2877,9 @@ class Robot private constructor(private val context: Context) {
     @WorkerThread
     @CheckResult
     @JvmOverloads
-    fun getAllTours(): List<TourModel> {
+    fun getAllTours(tags: List<String> = emptyList()): List<TourModel> {
         return try {
-            (sdkService?.getAllTours(applicationInfo.packageName)
+            (sdkService?.getAllTours(applicationInfo.packageName, tags.filter { it != "" })
                 ?: emptyList<TourModel>()).map { it.compatible() }
         } catch (e: RemoteException) {
             Log.e(TAG, "getAllTours() error")

From c5eae77170de01827fb4aa7f4417332675701a26 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Fri, 13 Oct 2023 11:06:22 +0800
Subject: [PATCH 06/12] add setAsrLanguages() and wakeup() with custom
 languages

---
 gradle.properties                             |  2 +-
 .../com/robotemi/sdk/sample/MainActivity.kt   | 13 +++++
 .../res/layout/group_settings_and_status.xml  | 10 ++++
 .../aidl/com/robotemi/sdk/ISdkService.aidl    |  4 +-
 sdk/src/main/java/com/robotemi/sdk/Robot.kt   | 19 ++++++-
 .../main/java/com/robotemi/sdk/SttLanguage.kt | 54 +++++++++++++++++++
 6 files changed, 98 insertions(+), 4 deletions(-)
 create mode 100644 sdk/src/main/java/com/robotemi/sdk/SttLanguage.kt

diff --git a/gradle.properties b/gradle.properties
index 513dec91..6c8111ce 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -21,7 +21,7 @@ android.enableJetifier=true
 kotlin.code.style=official
 
 GROUP=com.robotemi
-VERSION_NAME=1.132.0.1-SNAPSHOT
+VERSION_NAME=1.132.0.2-SNAPSHOT
 POM_URL=https://github.com/robotemi/sdk/
 POM_SCM_URL=https://github.com/robotemi/sdk/
 POM_SCM_CONNECTION=scm:git:git://github.com/robotemi/sdk.git
diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index 76e24674..ef17364f 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -339,6 +339,8 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         btnPublish.setOnClickListener { publishToActivityStream() }
         btnHideTopBar.setOnClickListener { hideTopBar() }
         btnShowTopBar.setOnClickListener { showTopBar() }
+        btnWakeup.setOnClickListener { wakeup() }
+        btnSetAsrLanguages.setOnClickListener { setAsrLanguages() }
         btnDisableWakeup.setOnClickListener { disableWakeup() }
         btnEnableWakeup.setOnClickListener { enableWakeup() }
         btnToggleNavBillboard.setOnClickListener { toggleNavBillboard() }
@@ -1153,6 +1155,17 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         printLog("Locations updated :\n$locations")
     }
 
+    private fun wakeup() {
+        robot.wakeup(listOf(SttLanguage.SYSTEM, SttLanguage.ZH_HK, SttLanguage.KO_KR))
+    }
+
+    private fun setAsrLanguages() {
+        if (!robot.isSelectedKioskApp()) {
+            return
+        }
+        robot.setAsrLanguages(listOf(SttLanguage.SYSTEM, SttLanguage.ZH_HK, SttLanguage.KO_KR))
+    }
+
     private fun disableWakeup() {
         if (requestPermissionIfNeeded(Permission.SETTINGS, REQUEST_CODE_NORMAL)) {
             return
diff --git a/sample/src/main/res/layout/group_settings_and_status.xml b/sample/src/main/res/layout/group_settings_and_status.xml
index 729d9d5b..5267555b 100644
--- a/sample/src/main/res/layout/group_settings_and_status.xml
+++ b/sample/src/main/res/layout/group_settings_and_status.xml
@@ -142,6 +142,16 @@
         style="@style/ButtonCommon"
         android:text="Set Volume" />
 
+    <Button
+        android:id="@+id/btnWakeup"
+        style="@style/ButtonCommon"
+        android:text="Wakeup" />
+
+    <Button
+        android:id="@+id/btnSetAsrLanguages"
+        style="@style/ButtonCommon"
+        android:text="Set ASR Languages" />
+
     <Button
         android:id="@+id/btnDisableWakeup"
         style="@style/ButtonCommon"
diff --git a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
index 5e6b2ea2..416112af 100644
--- a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
+++ b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
@@ -173,7 +173,7 @@ interface ISdkService {
      */
     boolean deleteLocation(in String name);
 
-    void wakeup();
+    void wakeup(in int[] languages);
 
     String getWakeupWord();
 
@@ -366,4 +366,6 @@ interface ISdkService {
     List<TourModel> getAllTours(in String packageName, in List<String> tags);
 
     int playTour(in String packageName, in String tourId);
+
+    int setAsrLanguages(in String packageName, in int[] languages);
 }
\ No newline at end of file
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index 08137e7f..a0d0a721 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -856,14 +856,29 @@ class Robot private constructor(private val context: Context) {
     /**
      * Trigger temi's wakeup programmatically.
      */
-    fun wakeup() {
+    fun wakeup(languages: List<SttLanguage> = emptyList()) {
         try {
-            sdkService?.wakeup()
+            sdkService?.wakeup(languages.map { it.value }.toIntArray())
         } catch (e: RemoteException) {
             Log.e(TAG, "wakeup() error")
         }
     }
 
+    /**
+     * Require Kiosk Permission
+     */
+    fun setAsrLanguages(sttLanguages: List<SttLanguage>): Int {
+        try {
+            return sdkService?.setAsrLanguages(
+                applicationInfo.packageName,
+                sttLanguages.map { it.value }.toIntArray()
+            ) ?: -1
+        } catch (e: RemoteException) {
+            Log.e(TAG, "setAsrLanguages() error")
+        }
+        return -1
+    }
+
     /**
      * Stops currently processed TTS request and empty the queue.
      */
diff --git a/sdk/src/main/java/com/robotemi/sdk/SttLanguage.kt b/sdk/src/main/java/com/robotemi/sdk/SttLanguage.kt
new file mode 100644
index 00000000..baff3011
--- /dev/null
+++ b/sdk/src/main/java/com/robotemi/sdk/SttLanguage.kt
@@ -0,0 +1,54 @@
+package com.robotemi.sdk
+
+enum class SttLanguage(val value: Int) {
+    SYSTEM(0),
+    EN_US(1),
+    ZH_CN(2),
+    JA_JP(3),
+    KO_KR(4),
+    ZH_HK(5),
+    ZH_TW(6),
+    DE_DE(7),
+    TH_TH(8),
+    IN_ID(9),
+    PT_BR(10),
+    AR_EG(11),
+    FR_CA(12),
+    FR_FR(13),
+    ES_ES(14),
+    CA_ES(15),
+    IW_IL(16),
+    IT_IT(17),
+    ET_EE(18),
+    TR_TR(19);
+
+    companion object {
+
+        @JvmStatic
+        fun valueToEnum(value: Int): SttLanguage {
+            return when (value) {
+                0 -> SYSTEM
+                1 -> EN_US
+                2 -> ZH_CN
+                3 -> JA_JP
+                4 -> KO_KR
+                5 -> ZH_HK
+                6 -> ZH_TW
+                7 -> DE_DE
+                8 -> TH_TH
+                9 -> IN_ID
+                10 -> PT_BR
+                11 -> AR_EG
+                12 -> FR_CA
+                13 -> FR_FR
+                14 -> ES_ES
+                15 -> CA_ES
+                16 -> IW_IL
+                17 -> IT_IT
+                18 -> ET_EE
+                19 -> TR_TR
+                else -> SYSTEM
+            }
+        }
+    }
+}
\ No newline at end of file

From 3dab06e0a1667946d994703e380dbf7fca1749b2 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Wed, 18 Oct 2023 13:54:35 +0800
Subject: [PATCH 07/12] add wakeup() with custom languages button

---
 .../main/java/com/robotemi/sdk/sample/MainActivity.kt  |  8 +++++++-
 .../src/main/res/layout/group_settings_and_status.xml  |  5 +++++
 sdk/src/main/java/com/robotemi/sdk/Robot.kt            | 10 ++++++++--
 3 files changed, 20 insertions(+), 3 deletions(-)

diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index ef17364f..bb88b135 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -340,6 +340,7 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         btnHideTopBar.setOnClickListener { hideTopBar() }
         btnShowTopBar.setOnClickListener { showTopBar() }
         btnWakeup.setOnClickListener { wakeup() }
+        btnWakeupCustomLanguages.setOnClickListener { wakeupCustomLanguages() }
         btnSetAsrLanguages.setOnClickListener { setAsrLanguages() }
         btnDisableWakeup.setOnClickListener { disableWakeup() }
         btnEnableWakeup.setOnClickListener { enableWakeup() }
@@ -1156,6 +1157,10 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
     }
 
     private fun wakeup() {
+        robot.wakeup()
+    }
+
+    private fun wakeupCustomLanguages() {
         robot.wakeup(listOf(SttLanguage.SYSTEM, SttLanguage.ZH_HK, SttLanguage.KO_KR))
     }
 
@@ -1163,7 +1168,8 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
         if (!robot.isSelectedKioskApp()) {
             return
         }
-        robot.setAsrLanguages(listOf(SttLanguage.SYSTEM, SttLanguage.ZH_HK, SttLanguage.KO_KR))
+        val ret = robot.setAsrLanguages(listOf(SttLanguage.SYSTEM, SttLanguage.ZH_HK, SttLanguage.KO_KR))
+        printLog("setAsrLanguages: $ret")
     }
 
     private fun disableWakeup() {
diff --git a/sample/src/main/res/layout/group_settings_and_status.xml b/sample/src/main/res/layout/group_settings_and_status.xml
index 5267555b..0c26a6bf 100644
--- a/sample/src/main/res/layout/group_settings_and_status.xml
+++ b/sample/src/main/res/layout/group_settings_and_status.xml
@@ -147,6 +147,11 @@
         style="@style/ButtonCommon"
         android:text="Wakeup" />
 
+    <Button
+        android:id="@+id/btnWakeupCustomLanguages"
+        style="@style/ButtonCommon"
+        android:text="Wakeup with Custom Languages" />
+
     <Button
         android:id="@+id/btnSetAsrLanguages"
         style="@style/ButtonCommon"
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index a0d0a721..226dc49c 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -855,6 +855,9 @@ class Robot private constructor(private val context: Context) {
 
     /**
      * Trigger temi's wakeup programmatically.
+     *
+     * @param languages - List of languages to be used for ASR. Overrides the setAsrLanguages() languages.
+     * If empty, then the system default languages will be used.
      */
     fun wakeup(languages: List<SttLanguage> = emptyList()) {
         try {
@@ -866,12 +869,15 @@ class Robot private constructor(private val context: Context) {
 
     /**
      * Require Kiosk Permission
+     *
+     * @param languages - List of languages to be used for ASR while the app is in kiosk.
+     * If empty, then the system default languages will be used.
      */
-    fun setAsrLanguages(sttLanguages: List<SttLanguage>): Int {
+    fun setAsrLanguages(languages: List<SttLanguage> = emptyList()): Int {
         try {
             return sdkService?.setAsrLanguages(
                 applicationInfo.packageName,
-                sttLanguages.map { it.value }.toIntArray()
+                languages.map { it.value }.toIntArray()
             ) ?: -1
         } catch (e: RemoteException) {
             Log.e(TAG, "setAsrLanguages() error")

From 8158f963f0e6e8178cc8c310714a85685706402c Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Fri, 20 Oct 2023 17:48:15 +0800
Subject: [PATCH 08/12] add sttLanguage on onAsrResult()

---
 gradle.properties                                           | 2 +-
 .../src/main/java/com/robotemi/sdk/sample/MainActivity.kt   | 5 +++--
 sdk/src/main/aidl/com/robotemi/sdk/ISdkServiceCallback.aidl | 2 +-
 sdk/src/main/java/com/robotemi/sdk/Robot.kt                 | 6 +++---
 4 files changed, 8 insertions(+), 7 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index 6c8111ce..b8422f45 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -21,7 +21,7 @@ android.enableJetifier=true
 kotlin.code.style=official
 
 GROUP=com.robotemi
-VERSION_NAME=1.132.0.2-SNAPSHOT
+VERSION_NAME=1.132.0.3-SNAPSHOT
 POM_URL=https://github.com/robotemi/sdk/
 POM_SCM_URL=https://github.com/robotemi/sdk/
 POM_SCM_CONNECTION=scm:git:git://github.com/robotemi/sdk.git
diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index bb88b135..1b3144a9 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -1213,9 +1213,10 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
      * And also need to select this App as the Kiosk Mode App in Settings > App > Kiosk.
      *
      * @param asrResult The result of the ASR after waking up temi.
+     * @param sttLanguage The detected language of the ASR result, default is SYSTEM
     </pre></pre> */
-    override fun onAsrResult(asrResult: String) {
-        printLog("onAsrResult", "asrResult = $asrResult")
+    override fun onAsrResult(asrResult: String, sttLanguage: SttLanguage) {
+        printLog("onAsrResult", "asrResult = $asrResult, sttLanguage = $sttLanguage")
         try {
             val metadata = packageManager
                 .getApplicationInfo(packageName, PackageManager.GET_META_DATA).metaData
diff --git a/sdk/src/main/aidl/com/robotemi/sdk/ISdkServiceCallback.aidl b/sdk/src/main/aidl/com/robotemi/sdk/ISdkServiceCallback.aidl
index cfc3d914..63a399db 100644
--- a/sdk/src/main/aidl/com/robotemi/sdk/ISdkServiceCallback.aidl
+++ b/sdk/src/main/aidl/com/robotemi/sdk/ISdkServiceCallback.aidl
@@ -58,7 +58,7 @@ interface ISdkServiceCallback {
 
     boolean onDetectionStateChanged(in int state);
 
-    boolean onAsrResult(in String asrText);
+    boolean onAsrResult(in String asrText, in int language);
 
     boolean onTelepresenceEventChanged(in CallEventModel callEventModel);
 
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index 226dc49c..ce772f8d 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -253,11 +253,11 @@ class Robot private constructor(private val context: Context) {
             return true
         }
 
-        override fun onAsrResult(asrText: String): Boolean {
+        override fun onAsrResult(asrText: String, language: Int): Boolean {
             if (asrListeners.isEmpty()) return false
             uiHandler.post {
                 for (asrListener in asrListeners) {
-                    asrListener.onAsrResult(asrText)
+                    asrListener.onAsrResult(asrText, SttLanguage.valueToEnum(language))
                 }
             }
             return true
@@ -3395,7 +3395,7 @@ class Robot private constructor(private val context: Context) {
     }
 
     interface AsrListener {
-        fun onAsrResult(asrResult: String)
+        fun onAsrResult(asrResult: String, sttLanguage: SttLanguage)
     }
 
     interface NlpListener {

From f6c5562228641f66d0df6e143b18058d599e0a93 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Wed, 25 Oct 2023 15:42:48 +0800
Subject: [PATCH 09/12] add faceRect on onFaceRecognized()/
 onContinuousFaceRecognized() result

---
 gradle.properties                             |  2 +-
 .../com/robotemi/sdk/sample/MainActivity.kt   | 14 +++++++-------
 .../com/robotemi/sdk/face/ContactModel.kt     | 19 ++++++++++++++++---
 3 files changed, 24 insertions(+), 11 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index b8422f45..09f9b999 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -21,7 +21,7 @@ android.enableJetifier=true
 kotlin.code.style=official
 
 GROUP=com.robotemi
-VERSION_NAME=1.132.0.3-SNAPSHOT
+VERSION_NAME=1.132.0.4-SNAPSHOT
 POM_URL=https://github.com/robotemi/sdk/
 POM_SCM_URL=https://github.com/robotemi/sdk/
 POM_SCM_CONNECTION=scm:git:git://github.com/robotemi/sdk.git
diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index 1b3144a9..dfafa5a6 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -1717,19 +1717,19 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
                 2 -> {
                     Log.d(
                         "SAMPLE_DEBUG",
-                        "VISITOR - onFaceRecognized ${contactModel.userId}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}"
+                        "VISITOR - onFaceRecognized ${contactModel.userId}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}"
                     )
                     printLog("onFaceRecognized: VISITOR ${contactModel.userId} ${contactModel.similarity}")
                 }
                 3 -> {
                     Log.d(
                         "SAMPLE_DEBUG",
-                        "SDK Face - onFaceRecognized ${contactModel.userId}, ${contactModel.firstName}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}"
+                        "SDK Face - onFaceRecognized ${contactModel.userId}, ${contactModel.firstName}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}"
                     )
-                    printLog("onFaceRecognized: SDK Face ${contactModel.userId}, ${contactModel.firstName}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}")
+                    printLog("onFaceRecognized: SDK Face ${contactModel.userId}, ${contactModel.firstName}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}")
                 }
                 -1 -> {
-                    printLog("onFaceRecognized: Unknown face, faceId ${contactModel.userId}, age ${contactModel.age}, gender ${contactModel.gender}")
+                    printLog("onFaceRecognized: Unknown face, faceId ${contactModel.userId}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}")
                 }
             }
         }
@@ -1763,19 +1763,19 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
                 2 -> {
                     Log.d(
                         "SAMPLE_DEBUG",
-                        "VISITOR - onContinuousFaceRecognized ${contactModel.userId}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}"
+                        "VISITOR - onContinuousFaceRecognized ${contactModel.userId}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}"
                     )
                     "$blinker  VISITOR ${contactModel.userId} similarity ${contactModel.similarity}\n"
                 }
                 3 -> {
                     Log.d(
                         "SAMPLE_DEBUG",
-                        "SDK Face - onContinuousFaceRecognized ${contactModel.userId}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}"
+                        "SDK Face - onContinuousFaceRecognized ${contactModel.userId}, similarity ${contactModel.similarity}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}"
                     )
                     "$blinker  SDK Face ${contactModel.userId} -> ${contactModel.firstName}, similarity ${contactModel.similarity}\n"
                 }
                 else -> {
-                    "$blinker Unknown face, faceId ${contactModel.userId}, age ${contactModel.age}, gender ${contactModel.gender}\n"
+                    "$blinker Unknown face, faceId ${contactModel.userId}, age ${contactModel.age}, gender ${contactModel.gender}, faceRect ${contactModel.faceRect}\n"
                 }
             }
         }
diff --git a/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt b/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt
index b3e79393..0697777f 100644
--- a/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt
@@ -1,5 +1,6 @@
 package com.robotemi.sdk.face
 
+import android.graphics.Rect
 import android.os.Parcel
 import android.os.Parcelable
 import org.json.JSONException
@@ -21,7 +22,8 @@ data class ContactModel @JvmOverloads constructor(
     val userId: String = "",
     val age: Int = 0,
     val userType: Int = 0,
-    val similarity: Double = 0.0
+    val similarity: Double = 0.0,
+    val faceRect: Rect = Rect()
 ) : Parcelable {
 
     constructor(source: Parcel) : this(
@@ -43,7 +45,7 @@ data class ContactModel @JvmOverloads constructor(
     }
 
     override fun toString(): String {
-        return "ContactModel(firstName=$firstName, lastName=$lastName, gender=$gender, imageKey=$imageKey, description=$description, userId=$userId, userType=$userType)"
+        return "ContactModel(firstName=$firstName, lastName=$lastName, gender=$gender, imageKey=$imageKey, description=$description, userId=$userId, userType=$userType faceRect=$faceRect)"
     }
 
     companion object {
@@ -58,6 +60,7 @@ data class ContactModel @JvmOverloads constructor(
         const val JSON_KEY_AGE = "age"
         const val JSON_KEY_SIMILARITY = "similarity"
         const val JSON_KEY_USER_TYPE = "userType"
+        const val JSON_KEY_FACE_RECT = "faceRect"
     }
 }
 
@@ -97,5 +100,15 @@ internal fun ContactModel.compatible(): ContactModel {
     } catch (e: JSONException) {
         0.0
     }
-    return this.copy(description = desc, userId = userId, age = age, userType = userType, similarity = similarity)
+    val faceRect: Rect = try {
+        val jsonFaceRect = json.optString(ContactModel.JSON_KEY_FACE_RECT, "")
+        if (jsonFaceRect.isNotEmpty()) {
+            Rect.unflattenFromString(jsonFaceRect) ?: Rect()
+        } else {
+            Rect()
+        }
+    } catch (e: JSONException) {
+        Rect()
+    }
+    return this.copy(description = desc, userId = userId, age = age, userType = userType, similarity = similarity, faceRect = faceRect)
 }
\ No newline at end of file

From 297fdbf6ff72f6d9a48f7f841a9e780ebed9a786 Mon Sep 17 00:00:00 2001
From: cyrus-rbc <cyrus@robocore.ai>
Date: Wed, 25 Oct 2023 17:49:54 +0800
Subject: [PATCH 10/12] add java doc for new field

---
 sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt b/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt
index 0697777f..ad07746d 100644
--- a/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/face/ContactModel.kt
@@ -12,6 +12,9 @@ import org.json.JSONObject
  *                 2: unregistered temi user, which is a visitor in greet mode face detection. User id will be an UUID.
  *                 3: sdk registered face, which is registered from SDK, only works in face recognition started from the same app.
  *                 -1: Detected but not recognized. User id will be a face id on such case.
+ * @param faceRect The rectangle coordinate of the face in the image.
+ *                 The face rectangle coordinate can be outside of the image, which is 800x600.
+ *                 Rect(0, 0, 0, 0) means no information/ unsupported feature.
  */
 data class ContactModel @JvmOverloads constructor(
     val firstName: String = "",
@@ -45,7 +48,7 @@ data class ContactModel @JvmOverloads constructor(
     }
 
     override fun toString(): String {
-        return "ContactModel(firstName=$firstName, lastName=$lastName, gender=$gender, imageKey=$imageKey, description=$description, userId=$userId, userType=$userType faceRect=$faceRect)"
+        return "ContactModel(firstName=$firstName, lastName=$lastName, gender=$gender, imageKey=$imageKey, description=$description, userId=$userId, userType=$userType, faceRect=$faceRect)"
     }
 
     companion object {

From 1832a6d9d91e9c9c098244fce38d2dcab4e51b16 Mon Sep 17 00:00:00 2001
From: Charlie <charlie@robocore.ai>
Date: Mon, 30 Oct 2023 16:45:18 +0800
Subject: [PATCH 11/12] Add blockRobotInteraction option

---
 gradle.properties                             |  2 +-
 .../com/robotemi/sdk/sample/MainActivity.kt   | 28 +++++++++++++++++++
 .../aidl/com/robotemi/sdk/ISdkService.aidl    |  2 +-
 sdk/src/main/java/com/robotemi/sdk/Robot.kt   | 10 ++++++-
 .../sdk/telepresence/LinkBasedMeeting.kt      |  9 +++++-
 5 files changed, 47 insertions(+), 4 deletions(-)

diff --git a/gradle.properties b/gradle.properties
index 09f9b999..f865b1a1 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -21,7 +21,7 @@ android.enableJetifier=true
 kotlin.code.style=official
 
 GROUP=com.robotemi
-VERSION_NAME=1.132.0.4-SNAPSHOT
+VERSION_NAME=1.132.0.5-SNAPSHOT
 POM_URL=https://github.com/robotemi/sdk/
 POM_SCM_URL=https://github.com/robotemi/sdk/
 POM_SCM_CONNECTION=scm:git:git://github.com/robotemi/sdk.git
diff --git a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
index dfafa5a6..aa8fcd3c 100644
--- a/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
+++ b/sample/src/main/java/com/robotemi/sdk/sample/MainActivity.kt
@@ -435,6 +435,34 @@ class MainActivity : AppCompatActivity(), NlpListener, OnRobotReadyListener,
                 }
             }
         }
+        btnCreateLinkBasedMeeting.setOnLongClickListener {
+            if (requestPermissionIfNeeded(Permission.MEETINGS, REQUEST_CODE_NORMAL)) {
+                // Permission not granted yet.
+            } else {
+                val request = LinkBasedMeeting(
+                    topic = "temi Demo Meeting",
+                    availability = LinkBasedMeeting.Availability(
+                        start = Date(),
+                        end = Date(Date().time + 86400000),
+                        always = false,
+                    ),
+                    limit = LinkBasedMeeting.Limit(
+                        callDuration = LinkBasedMeeting.CallDuration.MINUTE_10,
+                        usageLimit = LinkBasedMeeting.UsageLimit.NO_LIMIT,
+                    ),
+                    permission = LinkBasedMeeting.Permission.DISABLE_ROBOT_INTERACTION,
+                    security = LinkBasedMeeting.Security(
+                        password = "1122334455", // Should use a 1 to 10-digits password.
+                        hasPassword = false
+                    )
+                )
+                thread {
+                    val (code, linkUrl) = robot.createLinkBasedMeeting(request)
+                    printLog("Link create request, response code $code, link $linkUrl")
+                }
+            }
+            true
+        }
         btnStartPage.setOnClickListener { startPage() }
         btnRestart.setOnClickListener { restartTemi() }
         btnGetMembersStatus.setOnClickListener { getMembersStatus() }
diff --git a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
index 416112af..d875060e 100644
--- a/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
+++ b/sdk/src/main/aidl/com/robotemi/sdk/ISdkService.aidl
@@ -359,7 +359,7 @@ interface ISdkService {
 
     int enableStandBy(in String packageName, boolean enabled, in String password);
 
-    String startMeeting(in String packageName, in List<Participant> participants, boolean firstParticipantJoinedAsHost);
+    String startMeeting(in String packageName, in List<Participant> participants, boolean firstParticipantJoinedAsHost, boolean blockRobotInteraction);
 
     int configMinimumObstacleDistance(in String packageName, int value);
 
diff --git a/sdk/src/main/java/com/robotemi/sdk/Robot.kt b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
index ce772f8d..8c055354 100644
--- a/sdk/src/main/java/com/robotemi/sdk/Robot.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/Robot.kt
@@ -1602,6 +1602,7 @@ class Robot private constructor(private val context: Context) {
      * @param platform Platform of the target user.
      * @return
      */
+    @Deprecated("From 131 version, startMeeting() shall be used.")
     @JvmOverloads
     fun startTelepresence(
         displayName: String,
@@ -1648,15 +1649,22 @@ class Robot private constructor(private val context: Context) {
      * @param participants list of user names and peer ids.
      * @param firstParticipantJoinedAsHost, Set it as true to automatically assign first participant joined as meeting host.
      *                          Otherwise robot will be the host.
+     * @param blockRobotInteraction, supported by version 132 launcher,
+     *                       disable some launcher buttons in the call.
+     *                       Prevent user to interrupt the call.
      * @return 403 require MEETINGS permission
      *         200 OK.
      */
     fun startMeeting(
         participants: List<Participant>,
         firstParticipantJoinedAsHost: Boolean,
+        blockRobotInteraction: Boolean = false,
     ): String {
         try {
-            return sdkService?.startMeeting(applicationInfo.packageName, participants, firstParticipantJoinedAsHost) ?: ""
+            return sdkService?.startMeeting(applicationInfo.packageName,
+                participants,
+                firstParticipantJoinedAsHost,
+                blockRobotInteraction) ?: ""
         } catch (e: RemoteException) {
             Log.e(TAG, "startMeeting() error")
         }
diff --git a/sdk/src/main/java/com/robotemi/sdk/telepresence/LinkBasedMeeting.kt b/sdk/src/main/java/com/robotemi/sdk/telepresence/LinkBasedMeeting.kt
index 264dd1fe..24ea2400 100644
--- a/sdk/src/main/java/com/robotemi/sdk/telepresence/LinkBasedMeeting.kt
+++ b/sdk/src/main/java/com/robotemi/sdk/telepresence/LinkBasedMeeting.kt
@@ -72,14 +72,21 @@ data class LinkBasedMeeting(
     ) {
         companion object {
             val DEFAULT = Permission()
+            val DISABLE_ROBOT_INTERACTION = Permission(control = Control(blockRobotInteraction = true))
         }
     }
 
+    /**
+     * @param blockRobotInteraction, added in 132 version. Default as false.
+     * It will disable some robot ui in the meeting to prevent unwanted user interactions on the robot.
+     * e.g. Not allowing user to hang up from the robot.
+     */
     @Keep
     data class Control(
         @SerializedName("manualDrive") val manualDrive: Boolean = true,
         @SerializedName("screenControl") val screenControl: Boolean = true,
-        @SerializedName("locations") val locations: Locations = Locations()
+        @SerializedName("locations") val locations: Locations = Locations(),
+        @SerializedName("blockRobotInteraction") val blockRobotInteraction: Boolean = false
     )
 
     @Keep

From 7f825eb992abb40314b81c647366b0a50a190eb3 Mon Sep 17 00:00:00 2001
From: Charlie Zhang <charlie.zhang@robotemi.com>
Date: Thu, 23 Nov 2023 08:57:54 +0800
Subject: [PATCH 12/12] Bump version to 1.132.0

---
 gradle.properties | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/gradle.properties b/gradle.properties
index f865b1a1..988ae412 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -21,7 +21,7 @@ android.enableJetifier=true
 kotlin.code.style=official
 
 GROUP=com.robotemi
-VERSION_NAME=1.132.0.5-SNAPSHOT
+VERSION_NAME=1.132.0
 POM_URL=https://github.com/robotemi/sdk/
 POM_SCM_URL=https://github.com/robotemi/sdk/
 POM_SCM_CONNECTION=scm:git:git://github.com/robotemi/sdk.git