Aygıt Uygulamalarını Çalıştırma

Bir uygulamayı başlatmadan veya durdurmadan önce yetkili kaynak olarak aygıtın sunduğu uygulama listesini kullanın.

Ön Koşullar

• Aygıt bağlıdır ve DeviceAppsAPI protokolüne uyar.
• Yalnızca deviceApps tarafından döndürülen ham değerleri DeviceApp değerlerine dönüştürün.

AI desteğiyle uygulayın

AI ile geliştirin

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

Resmî “AIBuds Cihaz Uygulamalarını Yönetme” becerisini kullanarak iş akışını uygulamanıza uyarlayın.

https://docs-aibuds.github.io/tr/skills/manage-aibuds-device-apps adresini okuyup yönergeleri izleyin. Bu beceriyle “AIBuds Cihaz Uygulamalarını Yönetme” iş akışını iOS projesinde uygulayıp doğrulayın.

Resmî beceriyi görüntüle↗

API Reference

Framework

AIBuds.xcframework

Protokol

Swift

Swift

/// The protocol for device apps API. (Device Side Applications)
protocol DeviceAppsAPI: DeviceAPI {
    /// List of apps installed on the device, each element is an `NSNumber` wrapping the raw value of `DeviceApp`.
    var deviceApps: [NSNumber]? { get }

    /// Start the device side application.
    /// - Parameters:
    ///   - app: The app to start.
    ///   - completion: Reports success, the device status code, and an optional error.
    func startApp(_ app: DeviceApp, completion: AIBudsStatusCodeCompletionHandler?)

    /// Stop the device side application.
    /// - Parameters:
    ///   - app: The app to stop.
    ///   - completion: Reports success, the device status code, and an optional error.
    func stopApp(_ app: DeviceApp, completion: AIBudsStatusCodeCompletionHandler?)

    /// Stop all running applications and return to the home screen.
    /// - Parameter completion: Reports success and an optional error.
    func stopAllAppsAndReturnToHomeScreen(_ completion: AIBudsCompletionHandler?)

    /// Get the current foreground application.
    /// - Parameter completion: Reports success, the foreground app raw value, and an optional error.
    func getCurrentForegroundApp(
        _ completion: (
            (
                _ success: Bool,
                _ app: NSNumber?,
                _ error: NSError?
            ) -> Void
        )?
    )
}

Objective-C

Objective-C

/// The protocol for device apps API. (Device Side Applications)
@protocol AIBudsDeviceAppsAPI <AIBudsDeviceAPI>
@property(nonatomic, readonly, copy) NSArray<NSNumber *> *_Nullable deviceApps;

/// Start the device side application.
- (void)startApp:(enum AIBudsDeviceApp)app
      completion:(AIBudsStatusCodeCompletionHandler _Nullable)completion;

/// Stop the device side application.
- (void)stopApp:(enum AIBudsDeviceApp)app
     completion:(AIBudsStatusCodeCompletionHandler _Nullable)completion;

/// Stop all running applications and return to the home screen.
- (void)stopAllAppsAndReturnToHomeScreenWithCompletion:
    (AIBudsCompletionHandler _Nullable)completion;

/// Get the current foreground application.
- (void)getCurrentForegroundAppWithCompletion:
    (void (^_Nullable)(BOOL, NSNumber *_Nullable, NSError *_Nullable))completion;
@end

Semboller

Sembol	Amaç
deviceApps	Kullanılabilir aygıt uygulamalarının ham değerleri.
startApp	Bir uygulamayı başlatır.
stopApp	Bir uygulamayı durdurur.
stopAllAppsAndReturnToHomeScreen	Ana ekrana döner.
getCurrentForegroundApp	Ön plandaki uygulamayı sorgular.

Uygulama Değerleri

Swift	Objective-C	Ham değer	Anlamı
.homeScreen	AIBudsDeviceAppHomeScreen	0x00	Aygıt ana ekranı. startApp veya stopApp öğesine vermeyin.
.teleprompter	AIBudsDeviceAppTeleprompter	0x01	Teleprompter uygulaması.
.aiChat	AIBudsDeviceAppAiChat	0x02	AI sohbet uygulaması.
.navigation	AIBudsDeviceAppNavigation	0x03	Navigasyon uygulaması.
.clock	AIBudsDeviceAppClock	0x04	Saat uygulaması.
.translation	AIBudsDeviceAppTranslation	0x05	Çeviri uygulaması.

Kullanım Örnekleri

Swift

Swift

guard let device = device as? DeviceAppsAPI else { return }

let apps = (device.deviceApps ?? []).compactMap {
    DeviceApp(rawValue: $0.intValue)
}

guard let app = apps.first else {
    print("No device application is available")
    return
}

device.startApp(app) { success, statusCode, error in
    guard success else {
        print(error?.localizedDescription ?? "Application failed to start")
        return
    }
    print("Application started: \(statusCode?.stringValue ?? "Unavailable")")
}

device.getCurrentForegroundApp { success, rawApp, error in
    let foreground = rawApp.flatMap { DeviceApp(rawValue: $0.intValue) }
    print(
        success
            ? "Foreground: \(String(describing: foreground))"
            : (error?.localizedDescription ?? "Query failed"))
}

Objective-C

Objective-C

id<AIBudsDeviceAppsAPI> device = (id<AIBudsDeviceAppsAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceAppsAPI)])
    return;

NSNumber *rawApp = device.deviceApps.firstObject;
if (rawApp != nil) {
    AIBudsDeviceApp app = (AIBudsDeviceApp)rawApp.integerValue;
    [device startApp:app
          completion:^(BOOL success, NSNumber *_Nullable statusCode, NSError *_Nullable error) {
              if (!success)
                  NSLog(@"Application failed to start: %@", error.localizedDescription);
          }];
}

[device getCurrentForegroundAppWithCompletion:^(
            BOOL success, NSNumber *_Nullable app, NSError *_Nullable error) {
    NSLog(success ? @"Foreground app: %@" : @"Query failed: %@",
          success ? app : error.localizedDescription);
}];

Hata Yönetimi

Her DeviceApp case'inin her aygıtta bulunduğunu varsaymayın. Kullanılabilirlik için deviceApps, yetkili ön plan durumu için getCurrentForegroundApp kullanın ve ürüne özgü işleme için aygıt durum kodlarını koruyun.