Uzaktan Deklanşör Olaylarını İşleme

Uzaktan deklanşör olaylarını DeviceDelegate üzerinden alın, uygulama kamerasında karşılık gelen işlemi gerçekleştirin ve sonucu cihazla eşitleyin.

Ön Koşullar

• Cihaz bağlıdır ve DeviceRemoteShutterAPI protokolüne uyar.
• Uygulamada NSCameraUsageDescription girdisi bulunur ve kamera izni istenir.
• Uygulama kendi AVCaptureSession ve fotoğraf çekme uygulamasına sahiptir.

AI desteğiyle uygulayın

AI ile geliştirin

Bu iş akışını AI ile uygulayın

Resmî “AIBuds Uzaktan Deklanşörünü Uygulama” becerisini kullanarak iş akışını uygulamanıza uyarlayın.

https://docs-aibuds.github.io/tr/skills/implement-aibuds-remote-shutter adresini okuyup yönergeleri izleyin. Bu beceriyle “AIBuds Uzaktan Deklanşörünü Uygulama” iş akışını iOS projesinde uygulayıp doğrulayın.

Resmî beceriyi görüntüle↗

API Referansı

Protokol

Swift

Swift

/// The protocol for device remote shutter API.
protocol DeviceRemoteShutterAPI: DeviceAPI {
    /// Syncs the app’s real-time remote-shutter response state to the device after the device triggers remote shutter.
    /// - Parameters:
    ///   - state: The real-time remote-shutter response state to sync to the device.
    ///   - completion: A closure that is called when the operation completes.
    ///     - success: `true` if the operation was successful; otherwise `false`.
    ///     - error: An `NSError` object that describes the error that occurred, or `nil` if the operation was successful.
    func syncRemoteShutterStateToDevice(
        _ state: RemoteShutterState,
        completion: AIBudsCompletionHandler?
    )
}

Objective-C

Objective-C

/// The protocol for device remote shutter API.
@protocol AIBudsDeviceRemoteShutterAPI <AIBudsDeviceAPI>
/// Syncs the app’s real-time remote-shutter response state to the device after the device triggers
/// remote shutter.
/// - Parameters:
///   - state: The real-time remote-shutter response state to sync to the device.
///   - completion: A closure that is called when the operation completes.
///     - success: `true` if the operation was successful; otherwise `false`.
///     - error: An `NSError` object that describes the error that occurred, or `nil` if the
///     operation was successful.
- (void)syncRemoteShutterStateToDevice:(enum AIBudsRemoteShutterState)state
                            completion:(AIBudsCompletionHandler _Nullable)completion;
@end

API Referansındaki syncRemoteShutterStateToDevice öğesine bakın.

Delegate Callback'i

Swift

Swift

/// Callback when remote shutter event received
/// - Parameters:
///   - device: the device
///   - event: the remote shutter event
optional func device(
    _ device: DeviceConvertible,
    didReceiveRemoteShutterEvent event: RemoteShutterEvent
)

Objective-C

Objective-C

/// Callback when remote shutter event received
/// - Parameters:
///   - device: the device
///   - event: the remote shutter event
- (void)device:(id<AIBudsDeviceConvertible> _Nonnull)device
    didReceiveRemoteShutterEvent:(enum AIBudsRemoteShutterEvent)event;

Kullanım Örnekleri

Örnekte SDK olay akışının anlaşılır kalması için uygulama kamerasına ait ayrıntılar yerel yöntemlere bırakılır.

Swift

Swift

func device(
    _ device: DeviceConvertible,
    didReceiveRemoteShutterEvent event: RemoteShutterEvent
) {
    guard let remoteShutter = device as? DeviceRemoteShutterAPI else { return }

    switch event {
    case .enter:
        prepareAppCamera { ready in
            let state: RemoteShutterState =
                ready
                ? .enteredPhotoMode
                : .exitedOrUnableToEnter
            remoteShutter.syncRemoteShutterStateToDevice(state, completion: nil)
        }
    case .capture:
        captureAppPhoto { success in
            remoteShutter.syncRemoteShutterStateToDevice(
                success ? .photoSuccess : .photoFailed,
                completion: nil
            )
        }
    case .exit:
        stopAppCamera()
        remoteShutter.syncRemoteShutterStateToDevice(
            .exitedOrUnableToEnter,
            completion: nil
        )
    case .unknown:
        break
    }
}

Objective-C

Objective-C

- (void)device:(id<AIBudsDeviceConvertible>)device
    didReceiveRemoteShutterEvent:(AIBudsRemoteShutterEvent)event {
    id<AIBudsDeviceRemoteShutterAPI> remoteShutter = (id<AIBudsDeviceRemoteShutterAPI>)device;
    if (![remoteShutter conformsToProtocol:@protocol(AIBudsDeviceRemoteShutterAPI)])
        return;

    switch (event) {
    case AIBudsRemoteShutterEventEnter:
        [self prepareAppCameraWithCompletion:^(BOOL ready) {
            AIBudsRemoteShutterState state = ready ? AIBudsRemoteShutterStateEnteredPhotoMode
                                                   : AIBudsRemoteShutterStateExitedOrUnableToEnter;
            [remoteShutter syncRemoteShutterStateToDevice:state completion:nil];
        }];
        break;
    case AIBudsRemoteShutterEventCapture:
        [self captureAppPhotoWithCompletion:^(BOOL success) {
            AIBudsRemoteShutterState state = success ? AIBudsRemoteShutterStatePhotoSuccess
                                                     : AIBudsRemoteShutterStatePhotoFailed;
            [remoteShutter syncRemoteShutterStateToDevice:state completion:nil];
        }];
        break;
    case AIBudsRemoteShutterEventExit:
        [self stopAppCamera];
        [remoteShutter syncRemoteShutterStateToDevice:AIBudsRemoteShutterStateExitedOrUnableToEnter
                                           completion:nil];
        break;
    default:
        break;
    }
}

Hata Yönetimi

İzin reddedildiğinde, depolama kullanılamadığında veya uygulama kamerası çekim yapamadığında .photoFailed bildirin. Uygulama fotoğraf moduna giremediğinde ya da bu moddan çıktığında .exitedOrUnableToEnter bildirin.