सामान्य रिकॉर्डिंग

Connected device से standard audio recording session शुरू या बंद करने का अनुरोध करें।

आवश्यक शर्तें

• डिवाइस connected और ready है।
• डिवाइस DeviceAudioRecordingAPI को conform करता है।
• डिवाइस में recording के लिए पर्याप्त storage है।

API संदर्भ

Framework

AIBuds.xcframework

Import

Swift

Swift

import AIBuds

Objective-C

Objective-C

#import <AIBuds/AIBuds-Swift.h>
#import <AIBuds/AIBuds.h>

प्रोटोकॉल

Requests DeviceAudioRecordingAPI में defined हैं।

Swift

Swift

/// The protocol for device API that supports audio recording.
protocol DeviceAudioRecordingAPI: DeviceAPI {
    /// Requests the device to start an audio recording session.
    /// - Parameters:
    ///   - completion: A closure that is called when the operation completes.
    ///     - success: `true` if the operation was successful; otherwise `false`.
    ///     - statusCode: The status code returned by the device. `nil` if the operation failed.
    ///     - error: An `NSError` object that describes the error that occurred, or `nil` if the operation was successful.
    func requestStartAudioRecording(_ completion: AIBudsStatusCodeCompletionHandler?)

    /// Requests the device to stop the current audio recording session.
    /// - Parameters:
    ///   - completion: A closure that is called when the operation completes.
    ///     - success: `true` if the operation was successful; otherwise `false`.
    ///     - statusCode: The status code returned by the device. `nil` if the operation failed.
    ///     - error: An `NSError` object that describes the error that occurred, or `nil` if the operation was successful.
    func requestStopAudioRecording(_ completion: AIBudsStatusCodeCompletionHandler?)
}

Objective-C

Objective-C

/// The protocol for device API that supports audio recording.
@protocol AIBudsDeviceAudioRecordingAPI <AIBudsDeviceAPI>
/// Requests the device to start an audio recording session.
/// - Parameters:
///   - completion: A closure that is called when the operation completes.
///     - success: `true` if the operation was successful; otherwise `false`.
///     - statusCode: The status code returned by the device. `nil` if the operation failed.
///     - error: An `NSError` object that describes the error that occurred, or `nil` if the
///     operation was successful.
- (void)requestStartAudioRecordingWithCompletion:
    (AIBudsStatusCodeCompletionHandler _Nullable)completion;

/// Requests the device to stop the current audio recording session.
/// - Parameters:
///   - completion: A closure that is called when the operation completes.
///     - success: `true` if the operation was successful; otherwise `false`.
///     - statusCode: The status code returned by the device. `nil` if the operation failed.
///     - error: An `NSError` object that describes the error that occurred, or `nil` if the
///     operation was successful.
- (void)requestStopAudioRecordingWithCompletion:
    (AIBudsStatusCodeCompletionHandler _Nullable)completion;
@end

इंस्टेंस मेथड

Method	उपयोग
requestStartAudioRecording	डिवाइस से recording शुरू करने का अनुरोध करें।
requestStopAudioRecording	डिवाइस से recording बंद करने का अनुरोध करें।

पूर्णता मान

Name	Type	विवरण
success	Bool / BOOL	Request सफल हुआ या नहीं।
statusCode	NSNumber?	Device status code; operation fail होने पर nil।
error	NSError?	Failure details; success पर nil।

Methods recording file path नहीं लौटाते। Result device command status है।

उपयोग के उदाहरण

Swift

Swift

import AIBuds

guard let device = device as? DeviceAudioRecordingAPI else {
    print("Device does not support audio recording")
    return
}

device.requestStartAudioRecording { success, statusCode, error in
    guard success else {
        print("Start failed: \(error?.localizedDescription ?? "Unknown error")")
        return
    }
    print("Recording started, status: \(statusCode?.stringValue ?? "Unavailable")")
}

// Call this from the UI action that stops the active recording.
device.requestStopAudioRecording { success, statusCode, error in
    guard success else {
        print("Stop failed: \(error?.localizedDescription ?? "Unknown error")")
        return
    }
    print("Recording stopped, status: \(statusCode?.stringValue ?? "Unavailable")")
}

Objective-C

Objective-C

#import <AIBuds/AIBuds-Swift.h>
#import <AIBuds/AIBuds.h>

id<AIBudsDeviceAudioRecordingAPI> device = (id<AIBudsDeviceAudioRecordingAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceAudioRecordingAPI)]) {
    NSLog(@"Device does not support audio recording");
    return;
}

[device requestStartAudioRecordingWithCompletion:^(
            BOOL success, NSNumber *_Nullable statusCode, NSError *_Nullable error) {
    if (!success) {
        NSLog(@"Start failed: %@", error.localizedDescription);
        return;
    }
    NSLog(@"Recording started, status: %@", statusCode);
}];

// Call this from the UI action that stops the active recording.
[device requestStopAudioRecordingWithCompletion:^(
            BOOL success, NSNumber *_Nullable statusCode, NSError *_Nullable error) {
    if (!success) {
        NSLog(@"Stop failed: %@", error.localizedDescription);
        return;
    }
    NSLog(@"Recording stopped, status: %@", statusCode);
}];

त्रुटि प्रबंधन

Primary result के रूप में success उपयोग करें। Device-specific handling के लिए returned statusCode सुरक्षित रखें और available होने पर error दिखाएँ; public protocol individual status-code values का अर्थ नहीं बताता।