Kotlin SDK

1
import android.Manifest
2
import android.content.pm.PackageManager
3
import androidx.core.app.ActivityCompat
4
import androidx.core.content.ContextCompat
5
6
private fun requestMicrophonePermission() {
7
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.RECORD_AUDIO)
8
        != PackageManager.PERMISSION_GRANTED) {
9
10
        if (ActivityCompat.shouldShowRequestPermissionRationale(this, Manifest.permission.RECORD_AUDIO)) {
11
            // Show explanation to the user
12
            showPermissionExplanationDialog()
13
        } else {
14
            ActivityCompat.requestPermissions(
15
                this,
16
                arrayOf(Manifest.permission.RECORD_AUDIO),
17
                MICROPHONE_PERMISSION_REQUEST_CODE
18
            )
19
        }
20
    }
21
}

1
import io.elevenlabs.ConversationClient
2
import io.elevenlabs.ConversationConfig
3
import io.elevenlabs.ConversationSession
4
5
// Start a public agent session (token generated for you)
6
val config = ConversationConfig(
7
    agentId = "<your_public_agent_id>", // OR conversationToken = "<token>"
8
)
9
10
// In an Activity context
11
val session: ConversationSession = ConversationClient.startSession(config, this)

1
val config = ConversationConfig(
2
    agentId = "<your_public_agent_id>", // OR conversationToken = "<token>"
3
    userId = "your-user-id",
4
    // Optional callbacks
5
    onConnect = { conversationId ->
6
        // Called when the conversation is connected and returns the conversation ID. You can access conversationId via session.getId() too
7
    },
8
    onMessage = { source, messageJson ->
9
        // Raw JSON messages from data channel; useful for logging/telemetry
10
    },
11
    onModeChange = { mode ->
12
        // "speaking" | "listening" — drive UI indicators
13
    },
14
    onStatusChange = { status ->
15
        // "connected" | "connecting" | "disconnected"
16
    },
17
    onCanSendFeedbackChange = { canSend ->
18
        // Enable/disable thumbs up/down buttons for feedback reporting
19
    },
20
    onUnhandledClientToolCall = { call ->
21
        // Agent requested a client tool not registered on the device
22
    },
23
    onVadScore = { score ->
24
        // Voice Activity Detection score, range from 0 to 1 where higher values indicate higher confidence of speech
25
    }
26
    // List of client tools the agent can invoke
27
    clientTools = mapOf(
28
        // Example of a client tool that logs a message to the console
29
        // Remember that client tools need to be registered on the agent in the ElevenLabs dashboard
30
        "logMessage" to object : ClientTool {
31
            override suspend fun execute(parameters: Map<String, Any>): ClientToolResult {
32
                val message = parameters["message"] as? String
33
34
                Log.d("ExampleApp", "[INFO] Client Tool Log: $message")
35
                return ClientToolResult.success("Message logged successfully")
36
            }
37
        }
38
    ),
39
)

1
val session = ConversationClient.startSession(
2
    config = ConversationConfig(
3
        agentId = "your-agent-id"
4
    ),
5
    context = this
6
)

1
// Get conversation token from your server
2
val conversationToken = fetchConversationTokenFromServer()
3
4
// For private agents, pass in the conversation token
5
val session = ConversationClient.startSession(
6
    config = ConversationConfig(
7
        conversationToken = conversationToken
8
    ),
9
    context = this
10
)

1
val session = ConversationClient.startSession(
2
    config = ConversationConfig(
3
        agentId = "your-agent-id",
4
        userId = "your-user-id"
5
    ),
6
    context = this
7
)

1
session.endSession()

1
session.sendUserMessage("Hello, how can you help me?")

1
session.sendContextualUpdate(
2
    "User navigated to the profile page. Consider this for next response."
3
)

1
// Positive feedback
2
session.sendFeedback(true)
3
4
// Negative feedback
5
session.sendFeedback(false)

1
session.sendUserActivity()

1
session.toggleMute()
2
session.setMicMuted(true)   // mute
3
session.setMicMuted(false)  // unmute

1
val status = session.status
2
Log.d("Conversation", "Current status: $status")
3
// Values: DISCONNECTED, CONNECTING, CONNECTED