Swift SDK

1
// Configure the session
2
let config = ElevenLabsSDK.SessionConfig(agentId: "your-agent-id")
3
4
// Set up callbacks
5
var callbacks = ElevenLabsSDK.Callbacks()
6
callbacks.onConnect = { conversationId in
7
    print("Connected with ID: \(conversationId)")
8
}
9
callbacks.onDisconnect = {
10
    print("Disconnected")
11
}
12
callbacks.onMessage = { message, role in
13
    print("\(role.rawValue): \(message)")
14
}
15
callbacks.onError = { error, info in
16
    print("Error: \(error), Info: \(String(describing: info))")
17
}
18
callbacks.onStatusChange = { status in
19
    print("Status changed to: \(status.rawValue)")
20
}
21
callbacks.onModeChange = { mode in
22
    print("Mode changed to: \(mode.rawValue)")
23
}
24
callbacks.onVolumeUpdate = { volume in
25
    print("Volume updated: \(volume)")
26
}

1
// Create client tools instance
2
var clientTools = ElevenLabsSDK.ClientTools()
3
4
// Register a custom tool with an async handler
5
clientTools.register("generate_joke") { parameters async throws -> String? in
6
    // Parameters is a [String: Any] dictionary
7
    guard let joke = parameters["joke"] as? String else {
8
        throw ElevenLabsSDK.ClientToolError.invalidParameters
9
    }
10
    print("generate_joke tool received joke: \(joke)")
11
12
    return joke
13
}

1
Task {
2
    do {
3
        let conversation = try await ElevenLabsSDK.Conversation.startSession(
4
            config: config,
5
            callbacks: callbacks,
6
            clientTools: clientTools // Optional: pass the previously configured client tools
7
        )
8
        // Use the conversation instance
9
    } catch {
10
        print("Failed to start conversation: \(error)")
11
    }
12
}

1
struct ConversationalAIView: View {
2
    @State private var conversation: ElevenLabsSDK.Conversation?
3
    @State private var mode: ElevenLabsSDK.Mode = .listening
4
    @State private var status: ElevenLabsSDK.Status = .disconnected
5
    @State private var audioLevel: Float = 0.0
6
7
    private func startConversation() {
8
        Task {
9
            do {
10
                let config = ElevenLabsSDK.SessionConfig(agentId: "your-agent-id")
11
                var callbacks = ElevenLabsSDK.Callbacks()
12
13
                callbacks.onConnect = { conversationId in
14
                    status = .connected
15
                }
16
                callbacks.onDisconnect = {
17
                    status = .disconnected
18
                }
19
                callbacks.onModeChange = { newMode in
20
                    DispatchQueue.main.async {
21
                        mode = newMode
22
                    }
23
                }
24
                callbacks.onVolumeUpdate = { newVolume in
25
                    DispatchQueue.main.async {
26
                        audioLevel = newVolume
27
                    }
28
                }
29
30
                conversation = try await ElevenLabsSDK.Conversation.startSession(
31
                    config: config,
32
                    callbacks: callbacks
33
                )
34
            } catch {
35
                print("Failed to start conversation: \(error)")
36
            }
37
        }
38
    }
39
40
    var body: some View {
41
        VStack {
42
            // Your UI implementation
43
            Button(action: startConversation) {
44
                Text(status == .connected ? "End Call" : "Start Call")
45
            }
46
        }
47
    }
48
}