Управление приложениями устройства

Перед запуском или остановкой используйте список приложений устройства как достоверный источник.

Предварительные условия

• Устройство подключено и поддерживает DeviceAppsAPI.
• Преобразуйте в DeviceApp только исходные значения из deviceApps.

Реализация с помощью AI

Разработка с AI

Реализуйте этот сценарий с AI

Используйте официальный навык «Управление приложениями AIBuds» и адаптируйте сценарий к приложению.

Прочитайте и выполните инструкции https://docs-aibuds.github.io/ru/skills/manage-aibuds-device-apps. Используйте этот навык, чтобы реализовать «Управление приложениями AIBuds» в данном iOS-проекте и проверить результат.

Открыть официальный навык↗

Справочник API

Фреймворк

AIBuds.xcframework

Протокол

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

Символы

Символ	Назначение
deviceApps	Исходные значения доступных приложений устройства.
startApp	Запустить одно приложение.
stopApp	Остановить одно приложение.
stopAllAppsAndReturnToHomeScreen	Вернуться на главный экран.
getCurrentForegroundApp	Запросить активное приложение.

Значения приложений

Swift	Objective-C	Исходное значение	Смысл
.homeScreen	AIBudsDeviceAppHomeScreen	0x00	Главный экран устройства. Не передавайте в startApp или stopApp.
.teleprompter	AIBudsDeviceAppTeleprompter	0x01	Телесуфлёр.
.aiChat	AIBudsDeviceAppAiChat	0x02	Приложение AI-диалога.
.navigation	AIBudsDeviceAppNavigation	0x03	Навигация.
.clock	AIBudsDeviceAppClock	0x04	Часы.
.translation	AIBudsDeviceAppTranslation	0x05	Перевод.

Примеры использования

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);
}];

Обработка ошибок

Не считайте, что каждый вариант DeviceApp есть на любом устройстве. Доступность определяйте по deviceApps, достоверное активное состояние — по getCurrentForegroundApp, а коды состояния сохраняйте для продуктовой обработки.