Ses Düzeyi Yeteneğini ve Değerlerini Görüntüleme

Cihazın ses ayarlama yeteneğini ve o anda kullanılabilen ses düzeylerini okuyun.

Ön Koşullar

• Cihaz bağlı ve hazırdır.
• Cihaz DeviceVolumeControlAPI protokolüne uyar.

API Referansı

Framework

AIBuds.xcframework

İçe Aktarma

Swift

Swift

import AIBuds

Objective-C

Objective-C

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

Protokol

Swift

Swift

/// The protocol for device volume control API.
protocol DeviceVolumeControlAPI: DeviceAPI {
    /// The device's volume-set capability.
    var volumeSetCapability: VolumeSetCapability { get }

    /// Current volumes information of the device, or `nil` if unavailable.
    var volumesInfo: VolumesInfoModel? { get }
}

Objective-C

Objective-C

/// The protocol for device volume control API.
@protocol AIBudsDeviceVolumeControlAPI <AIBudsDeviceAPI>
/// The device's volume-set capability.
@property(nonatomic, readonly) enum AIBudsVolumeSetCapability volumeSetCapability;

/// Current volumes information of the device, or `nil` if unavailable.
@property(nonatomic, readonly, strong) AIBudsVolumesInfoModel *_Nullable volumesInfo;
@end

Özellikler

Özellik	Tür	Açıklama
volumeSetCapability	VolumeSetCapability	Ses düzeyi ayarlama yeteneği.
volumesInfo	VolumesInfoModel?	Güncel ses düzeyleri; kullanılamıyorsa nil.

Yetenek Değerleri

Değer	Güncel SDK'daki anlamı
.none	Ses düzeyi ayarlanamaz.
.common	Sistem bildirimi, medya ve görüşme kanalları ayarlanabilir.
.advanced	Güncel durum yerel oynatma sesini de bildirebilir; şu anda bunu ayarlayan genel bir API yoktur.

Ses Düzeyi Bilgileri

Özellik	Tür	Aralık	Açıklama
systemPromptVolume	NSNumber?	0–100	Güncel sistem bildirimi ses düzeyi.
mediaVolume	NSNumber?	0–100	Güncel medya oynatma ses düzeyi.
callVolume	NSNumber?	0–100	Güncel görüşme ses düzeyi.
localPlaybackVolume	NSNumber?	0–100	Güncel yerel oynatma ses düzeyi; mevcut genel API'de salt okunurdur.

Kullanım Örnekleri

Swift

Swift

import AIBuds

guard let device = device as? DeviceVolumeControlAPI else {
    print("Device does not support volume control")
    return
}

print("Capability: \(device.volumeSetCapability)")

if let volumes = device.volumesInfo {
    print("System prompt: \(volumes.systemPromptVolume?.intValue.description ?? "Unavailable")")
    print("Media: \(volumes.mediaVolume?.intValue.description ?? "Unavailable")")
    print("Call: \(volumes.callVolume?.intValue.description ?? "Unavailable")")
    print("Local playback: \(volumes.localPlaybackVolume?.intValue.description ?? "Unavailable")")
}

Objective-C

Objective-C

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

id<AIBudsDeviceVolumeControlAPI> device = (id<AIBudsDeviceVolumeControlAPI>)self.device;
if ([device conformsToProtocol:@protocol(AIBudsDeviceVolumeControlAPI)]) {
    AIBudsVolumesInfoModel *volumes = device.volumesInfo;
    NSLog(@"System prompt: %@", volumes.systemPromptVolume);
    NSLog(@"Media: %@", volumes.mediaVolume);
    NSLog(@"Call: %@", volumes.callVolume);
    NSLog(@"Local playback: %@", volumes.localPlaybackVolume);
}

Hata Yönetimi

Bu özelliklerin completion handler'ı yoktur. Desteklenmeyen protokolü, nil modeli ve ayrı nil kanal değerlerini varsayılan değer uydurmadan işleyin.

En İyi Uygulamalar

1. İsteğe Bağlı Değerleri Koruyun: nil değerini sıfır olarak göstermeyin.
2. Arayüz Kararlarında Yeteneği Kullanın: .none için tüm yazma denetimlerini gizleyin.
3. Güncellemeleri İzleyin: Canlı değer gerektiğinde didVolumesChanged delegate callback'inden yenileyin.

Notlar

• SDK, getVolumeControlSupport veya Result tabanlı sorgu yerine eşzamanlı özellikler sunar.
• Yerel oynatma ses düzeyi şu anda okunabilir ancak bağımsız olarak yazılamaz.