swift

Swift Bindings

C module map import of cactus_engine.h. Works on iOS and macOS.

Integration

cactus build --apple

XCFramework: drag apple/cactus-ios.xcframework (or apple/cactus-macos.xcframework) into Xcode (Embed & Sign). The framework bundles cactus_engine.h, so import cactus works directly.

Static library: link apple/libcactus_engine-device.a (or apple/libcactus_engine-simulator.a), copy bindings/swift/module.modulemap into your project, and add cactus-engine/ to Header Search Paths so the module map can find cactus_engine.h.

Usage

import cactus

let model = cactus_init("/path/to/model", nil, false)
var buf = [CChar](repeating: 0, count: 65536)
cactus_complete(model, messagesJson, &buf, buf.count, nil, nil, nil, nil, nil, 0)
let response = String(cString: buf)
cactus_destroy(model)

Streaming transcription

The streaming functions are exposed the same way. Push 16 kHz mono PCM16 as it arrives and read back {"success":true,"confirmed":...,"pending":...} — confirmed words are final, pending is the volatile tail.

let stream = cactus_stream_transcribe_start(model, "{\"language\":\"en\"}")
var buf = [CChar](repeating: 0, count: 65536)
for chunk in pcmChunks {            // each chunk: 16 kHz mono 16-bit PCM
    chunk.withUnsafeBytes { raw in
        _ = cactus_stream_transcribe_process(stream, raw.bindMemory(to: UInt8.self).baseAddress, raw.count, &buf, buf.count)
    }
    // parse String(cString: buf) -> append "confirmed", show "pending" live
}
cactus_stream_transcribe_stop(stream, &buf, buf.count)