screencapturekit 2.1.0

Safe Rust bindings for Apple's ScreenCaptureKit framework - screen and audio capture on macOS
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

// Audio device enumeration using AVFoundation

import AVFoundation
import Foundation

/// Represents an audio input device (microphone)
public struct AudioInputDevice {
    public let id: String
    public let name: String
    public let isDefault: Bool
}

// MARK: - FFI Functions

/// Get the count of available audio input devices
@_cdecl("sc_audio_get_input_device_count")
public func getInputDeviceCount() -> Int {
    let discoverySession = AVCaptureDevice.DiscoverySession(
        deviceTypes: [.builtInMicrophone, .externalUnknown],
        mediaType: .audio,
        position: .unspecified
    )
    return discoverySession.devices.count
}

/// Get audio input device ID at index into a buffer
@_cdecl("sc_audio_get_input_device_id")
public func getInputDeviceId(index: Int, buffer: UnsafeMutablePointer<CChar>?, bufferSize: Int) -> Bool {
    guard let buffer, bufferSize > 0 else { return false }

    let discoverySession = AVCaptureDevice.DiscoverySession(
        deviceTypes: [.builtInMicrophone, .externalUnknown],
        mediaType: .audio,
        position: .unspecified
    )
    let devices = discoverySession.devices
    guard index >= 0, index < devices.count else { return false }

    let deviceId = devices[index].uniqueID
    return deviceId.withCString { src in
        let length = strlen(src)
        guard length < bufferSize else { return false }
        strcpy(buffer, src)
        return true
    }
}

/// Get audio input device name at index into a buffer
@_cdecl("sc_audio_get_input_device_name")
public func getInputDeviceName(index: Int, buffer: UnsafeMutablePointer<CChar>?, bufferSize: Int) -> Bool {
    guard let buffer, bufferSize > 0 else { return false }

    let discoverySession = AVCaptureDevice.DiscoverySession(
        deviceTypes: [.builtInMicrophone, .externalUnknown],
        mediaType: .audio,
        position: .unspecified
    )
    let devices = discoverySession.devices
    guard index >= 0, index < devices.count else { return false }

    let deviceName = devices[index].localizedName
    return deviceName.withCString { src in
        let length = strlen(src)
        guard length < bufferSize else { return false }
        strcpy(buffer, src)
        return true
    }
}

/// Check if the device at index is the default audio input device
@_cdecl("sc_audio_is_default_input_device")
public func isDefaultInputDevice(index: Int) -> Bool {
    let discoverySession = AVCaptureDevice.DiscoverySession(
        deviceTypes: [.builtInMicrophone, .externalUnknown],
        mediaType: .audio,
        position: .unspecified
    )
    let devices = discoverySession.devices
    guard index >= 0, index < devices.count else { return false }

    // The default device is typically the one returned by default()
    if let defaultDevice = AVCaptureDevice.default(for: .audio) {
        return devices[index].uniqueID == defaultDevice.uniqueID
    }
    return false
}

/// Get the default audio input device ID into a buffer
@_cdecl("sc_audio_get_default_input_device_id")
public func getDefaultInputDeviceId(buffer: UnsafeMutablePointer<CChar>?, bufferSize: Int) -> Bool {
    guard let buffer, bufferSize > 0 else { return false }
    guard let device = AVCaptureDevice.default(for: .audio) else { return false }

    return device.uniqueID.withCString { src in
        let length = strlen(src)
        guard length < bufferSize else { return false }
        strcpy(buffer, src)
        return true
    }
}

/// Get the default audio input device name into a buffer
@_cdecl("sc_audio_get_default_input_device_name")
public func getDefaultInputDeviceName(buffer: UnsafeMutablePointer<CChar>?, bufferSize: Int) -> Bool {
    guard let buffer, bufferSize > 0 else { return false }
    guard let device = AVCaptureDevice.default(for: .audio) else { return false }

    return device.localizedName.withCString { src in
        let length = strlen(src)
        guard length < bufferSize else { return false }
        strcpy(buffer, src)
        return true
    }
}