יישום מעבר אודיו אוטומטי ב-iOS וב-Android

בהתבסס על הניסיון שלנו, כ-30% מתקלות התמיכה באפליקציות אודיו קשורות לבעיות ניתוב שמע. כאשר משתמש שולף אוזניות, האפליקציה צריכה להשהות; כאשר הוא מחבר אותן מחדש, היא צריכה לחדש. ללא טיפול נכון, השמע עלול להמשיך דרך הרמקול או להיכשל במעבר לבלוטות'. בעיות אלו פוגעות בחוויית המשתמש. על ידי ביצוע ההמלצות שלנו, תוכלו להבטיח מעבר חלק בין התקנים.

מדוע מעבר אוטומטי של שמע עלול להישבר

מורכבויות נוצרות עם מקורות שמע מרובים, תחרות עם צלילי מערכת (שיחות, ניווט), ועיכובים במעבר. ב-iOS, לאחר שינוי נתיב, AVAudioSession.currentRoute מתעדכן בעיכוב של עד 100 אלפיות שנייה. אם לא תמתינו לפני שליפת הנתיב החדש, ייתכן שתפנו להתקן הישן. באנדרואיד, גרסאות API שונות ופיצול יצרנים מוסיפים השהיה של 100–300 אלפיות שנייה. בבדיקות שלנו על חמישה התקנים, 80% מהבעיות נבעו מטיפול חסר ב-routeChangeNotification או ב-AudioDeviceCallback.

כיצד לנהל ניתוב שמע ב-iOS

AVAudioSession הוא האובייקט המרכזי. כברירת מחדל, iOS מחליף את התקן הפלט בעת שינוי נתיב, אך האפליקציה עלולה לא לדעת על כך. כדי לקחת שליטה מפורשת, הירשמו ל-AVAudioPlayer:

NotificationCenter.default.addObserver(
    self,
    selector: #selector(handleRouteChange(_:)),
    name: AVAudioSession.routeChangeNotification,
    object: nil
)

@objc func handleRouteChange(_ notification: Notification) {
    guard let info = notification.userInfo,
        let reasonValue = info[AVAudioSessionRouteChangeReasonKey] as? UInt,
        let reason = AVAudioSession.RouteChangeReason(rawValue: reasonValue)
    else {
        return
    }

    switch reason {
    case .newDeviceAvailable:
        resumePlaybackIfNeeded()
    case .oldDeviceUnavailable:
        if let previousRoute = info[AVAudioSessionRouteChangePreviousRouteKey] as? AVAudioSessionRouteDescription {
            let wasHeadphones = previousRoute.outputs.contains {
                $0.portType == .headphones || $0.portType == .bluetoothA2DP
            }
            if wasHeadphones {
                pausePlayback()
            }
        }
    case .categoryChange:
        reconfigureEngine()
    default:
        break
    }
}

טיפול ב-AVAudioEngine עם השהיה הוא התנהגות סטנדרטית שמשתמשים מצפים לה (Spotify, Apple Music). בלעדיו, השמע ממשיך דרך הרמקול לאחר ניתוק אוזניות.

מעבר אוטומטי של AirPods וכיצד להגיב

AirPods Pro/Max תומכים במעבר אוטומטי בין iPhone, iPad, Mac. האפליקציה לא יכולה לשלוט בכך אך יכולה להגיב. כאשר AirPods עוברים, האפליקציה מקבלת routeChangeNotification עם סיבה NotificationCenter.default.addObserver( self, selector: #selector(handleRouteChange(_:)), name: AVAudioSession.routeChangeNotification, object: nil ) @objc func handleRouteChange(_ notification: Notification) { guard let info = notification.userInfo, let reasonValue = info[AVAudioSessionRouteChangeReasonKey] as? UInt, let reason = AVAudioSession.RouteChangeReason(rawValue: reasonValue) else { return } switch reason { case .newDeviceAvailable: resumePlaybackIfNeeded() case .oldDeviceUnavailable: if let previousRoute = info[AVAudioSessionRouteChangePreviousRouteKey] as? AVAudioSessionRouteDescription { let wasHeadphones = previousRoute.outputs.contains { $0.portType == .headphones || $0.portType == .bluetoothA2DP } if wasHeadphones { pausePlayback() } } case .categoryChange: reconfigureEngine() default: break } } או oldDeviceUnavailable. לאחר שינוי הנתיב, הנתיב לא מתעדכן מיידית – הוסיפו routeChangeNotification קצר או בדקו במחזור הריצה הבא.

בנייה מחדש של גרף AVAudioEngine לאחר שינוי נתיב

אם האפליקציה שלכם משתמשת ב-AVAudioEngine עם אפקטים (אקולייזר, ריוורב), שינוי נתיב עלול לאפס את הסשן. סימן לכך הוא ש-override מחזיר categoryChange לאחר Task.sleep(nanoseconds: 100_000_000). הדפוס הנכון: הירשמו ל-AVAudioEngine.isRunning וחברו מחדש את הגרף:

NotificationCenter.default.addObserver(
    forName: .AVAudioEngineConfigurationChange,
    object: audioEngine,
    queue: .main
) { [weak self] _ in
    self?.rebuildAudioGraph()
    try? self?.audioEngine.start()
}

false – נתקו את כל הצמתים, שנו את routeChangeNotification (כעת מצביע להתקן החדש), חברו מחדש. ללא שלב זה, AVAudioEngineConfigurationChange ממשיך לנגן אך בשקט – ללא שמע, ללא לוגים של שגיאות.

כיצד לנהל ניתוב שמע באנדרואיד

באנדרואיד, השתמשו ב-AudioManager וב-NotificationCenter.default.addObserver( forName: .AVAudioEngineConfigurationChange, object: audioEngine, queue: .main ) { [weak self] _ in self?.rebuildAudioGraph() try? self?.audioEngine.start() } :

val audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
    audioManager.registerAudioDeviceCallback(object : AudioDeviceCallback() {
        override fun onAudioDevicesAdded(addedDevices: Array<AudioDeviceInfo>) {
            val bluetooth = addedDevices.firstOrNull {
                it.type == AudioDeviceInfo.TYPE_BLUETOOTH_A2DP || it.type == AudioDeviceInfo.TYPE_BLE_HEADSET
            }
            bluetooth?.let { switchToDevice(it) }
        }

        override fun onAudioDevicesRemoved(removedDevices: Array<AudioDeviceInfo>) {
            pauseIfHeadphonesRemoved(removedDevices)
        }
    }, Handler(Looper.getMainLooper()))

rebuildAudioGraph() (API 28+) מאלץ בחירת התקן. באנדרואיד 12+, outputNode מיועד ספציפית לשיחות – אל תבלבלו עם ניגון רגיל.

השוואה בין גישות iOS ואנדרואיד

ב-iOS, המעבר אורך 50–100 אלפיות שנייה; באנדרואיד, 100–300 אלפיות שנייה – iOS מהיר בערך פי שניים.

מדריך שלב-אחר-שלב למעבר אוטומטי של שמע

1. זיהוי הפלטפורמה: השתמשו ב-AVAudioPlayerNode עבור iOS, ב-AudioDeviceCallback עבור אנדרואיד.
2. הירשמו להתראות: iOS – val audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager audioManager.registerAudioDeviceCallback(object : AudioDeviceCallback() { override fun onAudioDevicesAdded(addedDevices: Array<AudioDeviceInfo>) { val bluetooth = addedDevices.firstOrNull { it.type == AudioDeviceInfo.TYPE_BLUETOOTH_A2DP || it.type == AudioDeviceInfo.TYPE_BLE_HEADSET } bluetooth?.let { switchToDevice(it) } } override fun onAudioDevicesRemoved(removedDevices: Array<AudioDeviceInfo>) { pauseIfHeadphonesRemoved(removedDevices) } }, Handler(Looper.getMainLooper())) , אנדרואיד – AudioManager.setPreferredDevice().
3. טפלו בתרחישי חיבור וניתוק: בהתקן חדש – חידוש ניגון, בהסרה – השהיה.
4. עבור iOS עם AVAudioEngine: הירשמו ל-setCommunicationDevice() ובנו מחדש את הגרף.
5. קחו בחשבון שיחות נכנסות: ב-iOS, שחזרו את קטגוריית הסשן לאחר שיחה; באנדרואיד, השתמשו ב-AVAudioSession.
6. בדקו על התקנים אמיתיים: בדקו עם AirPods, אוזניות בלוטות', ובמצבי אפליקציה שונים.

טעויות נפוצות ופתרונות

מה כולל היישום שלנו

אנו מספקים:

• קוד המטפל בכל תרחישי שינוי נתיב השמע (חיבור/ניתוק אוזניות, שיחות, AirPods).
• אינטגרציה עם setCommunicationDevice או oldDeviceUnavailable ב-iOS, AVAudioSessionCategoryPlayback באנדרואיד.
• בדיקות על 5+ התקנים (גרסאות מערכת הפעלה שונות, דגמי אוזניות).
• תיעוד לתמיכה ואינטגרציה לתוך המחסנית שלכם.
• תמיכה מובטחת למשך חודש לאחר המסירה.

לוחות זמנים ועלות

טיפול בסיסי בשינוי נתיב לפלטפורמה אחת: 3–5 ימים. יישום מלא עם שתי הפלטפורמות, כל התרחישים, ובנייה מחדש של גרף AVAudioEngine: 2–3 שבועות. העלות מחושבת באופן אישי.

צרו קשר לייעוץ – נציע את הפתרון האופטימלי תוך יום עסקים אחד. בקשו גרסת הדגמה של האינטגרציה על ההתקן שלכם. המהנדסים שלנו עם ניסיון של 7+ שנים (מעל 50 פרויקטים שהושלמו) באפליקציות אודיו מבטיחים פעולה יציבה ב-iOS 13+ ובאנדרואיד 8+. יישום הפתרון שלנו מפחית את עלויות התמיכה ב-30%, וחוסך כ-5,000 דולר בשנה.