Add setOutputMedium (#8)

Author: mdepinet

README.md

@@ -7,15 +7,23 @@ Android client SDK for [Ultravox](https://ultravox.ai).
 ## Usage
 
 ```kotlin
-val sessionState = session.joinCall(joinText.text.toString())
-sessionState.listen("transcript") {
+session.listen("transcript") {
     run {
-        val last = sessionState.lastTranscript
+        val last = session.lastTranscript
         // Do stuff with the transcript
     }
 }
+session.joinCall(joinText.text.toString())
 ```
 
 See the included example app for a more complete example. To get a `joinUrl`, you'll want to
 integrate your server with the [Ultravox REST API](https://fixie-ai.github.io/ultradox/).
 
+## Publishing
+
+1. Bump the version in ultravox_client's build.gradle.kts
+2. Uncomment the "LocalForCentralUpload" maven repository block in the same gradle file
+3. Uncomment and properly populate the three signing-related values in gradle.properties
+4. Run publishToMaven
+5. Compress the output "ai" directory into a zip file
+6. Upload that zip to https://central.sonatype.com/publishing and work through the UI to publish

gradle.properties

@@ -20,4 +20,10 @@ kotlin.code.style=official
 # Enables namespacing of each library's R class so that its R class includes only the
 # resources declared in the library itself and none from the library's dependencies,
 # thereby reducing the size of the R class for that library
-android.nonTransitiveRClass=true
+android.nonTransitiveRClass=true
+# The last 8 digits of your pub key id from gpg. Get with `gpg --list-keys`
+#signing.keyId=
+# The password for your keyring. DO NOT COMMIT
+#signing.password=
+# Path to your exported keyring from `gpg --keyring secring.gpg --export-secret-key $keyId_from_above > ~/tmp/secring.gpg`
+signing.secretKeyRingFile=/home/mike/tmp/secring.gpg

ultravox_client/build.gradle.kts

@@ -49,7 +49,7 @@ publishing {
         register<MavenPublication>("release") {
             groupId = "ai.fixie"
             artifactId = "ultravox-client-sdk"
-            version = "0.1.2"
+            version = "0.1.4"
 
             pom {
                 name = "Ultravox Client"

ultravox_client/src/main/java/ai/ultravox/UltravoxSession.kt

@@ -198,6 +198,20 @@ class UltravoxSession(
         disconnect()
     }
 
+    /**
+     * Sets the agent's output medium. If the agent is currently speaking, this will take effect at
+     * the end of the agent's utterance. Also see [speakerMuted].
+     */
+    fun setOutputMedium(medium: Transcript.Medium) {
+        if (!status.live) {
+            throw RuntimeException("Cannot set output medium while not connected. Current status is $status.")
+        }
+        val message = JSONObject()
+        message.put("type", "set_output_medium")
+        message.put("medium", medium.name.lowercase())
+        sendData(message)
+    }
+
     /** Sends a message via text. */
     fun sendText(text: String) {
         if (!status.live) {