مدیریت تنظیم کانون صوتی

دو یا چند برنامه Android می‌توانند به‌طور هم‌زمان صدا را در یک جاری‌سازی خروجی پخش کنند و سیستم همه را باهم ترکیب می‌کند. اگرچه این کار ازنظر فنی جالب است، اما می‌تواند برای کاربر بسیار آزاردهنده باشد. برای جلوگیری از پخش هم‌زمان همه برنامه‌های موسیقی، Android مفهوم تمرکز صوتی را معرفی می‌کند. در هر زمان فقط یک برنامه می‌تواند تمرکز صوتی را حفظ کند.

وقتی برنامه‌تان نیاز به خروجی صوتی دارد، باید درخواست تمرکز صوتی کند. وقتی در کانون توجه باشد، می‌تواند صدا پخش کند. بااین‌حال، پس‌از کسب تمرکز صوتی ممکن است نتوانید آن را تا پایان پخش حفظ کنید. برنامه دیگری می‌تواند درخواست تمرکز کند، که تمرکز صوتی شما را پیش‌دستی می‌کند. اگر این اتفاق بیفتد، برنامه‌تان باید پخش را موقتاً متوقف کند یا میزان صدا را کاهش دهد تا کاربران بتوانند منبع صوتی جدید را راحت‌تر بشنوند.

قبل‌از Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱)، اولویت صوتی توسط سیستم مدیریت نمی‌شود. بنابراین، درحالی‌که توسعه‌دهندگان نرم‌افزار تشویق می‌شوند از دستورالعمل‌های تمرکز صوتی پیروی کنند، اگر برنامه‌ای حتی پس‌از ازدست دادن تمرکز صوتی در دستگاهی با Android نسخه ۱۱ (سطح میانای برنامه‌سازی کاربردی ۳۰) یا پایین‌تر همچنان با صدای بلند پخش شود، سیستم نمی‌تواند از آن جلوگیری کند. بااین‌حال، این رفتار برنامه منجر به تجربه کاربری بدی می‌شود و اغلب می‌تواند کاربران را به حذف نصب برنامه بدرفتار سوق دهد.

یک برنامه صوتی با طراحی خوب باید تمرکز صوتی را طبق این دستورالعمل‌های کلی مدیریت کند:

  • بلافاصله قبل‌از شروع پخش، requestAudioFocus() را فراخوانی کنید و درستی‌سنجی کنید که فراخوانی AUDIOFOCUS_REQUEST_GRANTED را برمی‌گرداند. تماس را با requestAudioFocus() در onPlay() تماس برگشتی جلسه رسانه برقرار کنید.

  • وقتی برنامه دیگری تمرکز صوتی را به‌دست می‌آورد، پخش را متوقف یا موقتاً متوقف کنید، یا صدا را کاهش دهید.

  • وقتی بازپخش متوقف می‌شود (برای مثال، وقتی برنامه چیزی برای پخش ندارد)، تمرکز صوتی را رها کنید. اگر کاربر بازپخش را موقتاً متوقف کند اما ممکن باشد بعداً بازپخش را ازسر بگیرد، برنامه شما نباید تمرکز صوتی را رها کند.

  • از AudioAttributes برای توصیف نوع صدایی که برنامه‌تان پخش می‌کند استفاده کنید. برای مثال، برای برنامه‌هایی که گفتار پخش می‌کنند، CONTENT_TYPE_SPEECH را مشخص کنید.

تمرکز صوتی بسته به نسخه Android درحال اجرا به‌طور متفاوتی مدیریت می‌شود:

‫Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱) یا جدیدتر
تمرکز صوتی توسط سیستم مدیریت می‌شود. وقتی برنامه دیگری درخواست تمرکز صوتی می‌کند، سیستم پخش صدا از برنامه را مجبور به محو شدن می‌کند. همچنین، سیستم هنگام دریافت تماس ورودی، بازپخش صدا را صامت می‌کند.
Android 8.0 (سطح میانای برنامه‌سازی کاربردی ۲۶) تا Android 11 (سطح میانای برنامه‌سازی کاربردی ۳۰)
تمرکز صوتی توسط سیستم مدیریت نمی‌شود، اما شامل برخی تغییرات است که از Android 8.0 (سطح API 26) معرفی شده‌اند.
‫Android 7.1 (سطح میانای برنامه‌سازی کاربردی ۲۵) و پایین‌تر
تمرکز صوتی توسط سیستم مدیریت نمی‌شود و برنامه‌ها تمرکز صوتی را بااستفاده از requestAudioFocus() و abandonAudioFocus() مدیریت می‌کنند.

تمرکز صوتی در Android 12 و بالاتر

برنامه رسانه یا بازی که از اولویت صوتی استفاده می‌کند نباید پس‌از ازدست دادن اولویت، صدا پخش کند. در Android 12 (سطح میانای برنامه‌سازی کاربردی ۳۱) و بالاتر، سیستم این رفتار را اعمال می‌کند. وقتی برنامه‌ای درخواست اولویت صوتی می‌کند درحالی‌که برنامه دیگری اولویت را دارد و درحال پخش است، سیستم برنامه درحال پخش را مجبور می‌کند که محو شود. افزودن محو شدن تدریجی باعث می‌شود انتقال از برنامه‌ای به برنامه دیگر روان‌تر انجام شود.

این رفتار محو شدن زمانی اتفاق می‌افتد که شرایط زیر برقرار باشد:

  1. اولین برنامه درحال پخش همه این معیارها را دارد:

  2. برنامه دوم با AudioManager.AUDIOFOCUS_GAIN درخواست تمرکز صوتی می‌کند.

وقتی این شرایط برآورده شود، سیستم صوتی برنامه اول را محو می‌کند. در پایان محو شدن، سیستم به برنامه اول اطلاع می‌دهد که تمرکز را ازدست داده است. پخش‌کننده‌های برنامه تا زمانی که برنامه دوباره درخواست تمرکز صوتی نکند، بی‌صدا می‌مانند.

رفتارهای تمرکز صوتی موجود

همچنین باید از این موارد دیگر که شامل تغییر در تمرکز صوتی است آگاه باشید.

کاهش خودکار صدای پس‌زمینه

کاهش تداخل صوتی خودکار (کاهش موقت سطح صدای یک برنامه به‌طوری‌که برنامه دیگر به‌وضوح شنیده شود) در Android 8.0 (سطح میانای برنامه‌سازی کاربردی ۲۶) معرفی شد.

با پیاده‌سازی کاهش موقت صدا توسط سیستم، نیازی به پیاده‌سازی کاهش موقت صدا در برنامه‌تان ندارید.

کاهش خودکار صدا همچنین زمانی رخ می‌دهد که یک اعلان صوتی تمرکز را از یک برنامه درحال پخش می‌گیرد. شروع پخش اعلان با پایان شیب کاهش صدا همگام‌سازی می‌شود.

کاهش خودکار صدای پس‌زمینه زمانی اتفاق می‌افتد که شرایط زیر برقرار باشد:

  1. برنامه اول که درحال‌حاضر درحال پخش است، همه این معیارها را دارد:

  2. برنامه دوم با AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK درخواست تمرکز صوتی می‌کند.

وقتی این شرایط برآورده شود، سیستم صوتی صدای همه پخش‌کننده‌های فعال برنامه اول را درحین تمرکز برنامه دوم کاهش می‌دهد. وقتی برنامه دوم تمرکز را رها می‌کند، آن‌ها را از حالت کاهش صدا خارج می‌کند. برنامه اول وقتی تمرکز را ازدست می‌دهد مطلع نمی‌شود، بنابراین لازم نیست کاری انجام دهد.

توجه داشته باشید که وقتی کاربر درحال گوش دادن به محتوای گفتاری است، کاهش خودکار صدا انجام نمی‌شود، زیرا ممکن است کاربر بخشی از برنامه را ازدست بدهد. برای مثال، راهنمای گفتاری برای مسیرهای رانندگی تضعیف نمی‌شود.

صامت کردن پخش صدای فعلی برای تماس‌های تلفنی ورودی

برخی‌از برنامه‌ها به‌درستی عمل نمی‌کنند و درطول تماس‌های تلفنی به پخش صدا ادامه می‌دهند. این وضعیت کاربر را مجبور می‌کند برنامه متخلف را پیدا کند و آن را بی‌صدا کند یا از آن خارج شود تا بتواند صدای تماس را بشنود. برای جلوگیری از این اتفاق، سیستم می‌تواند صدای برنامه‌های دیگر را هنگام تماس ورودی بی‌صدا کند. وقتی تماس تلفنی ورودی دریافت می‌شود و برنامه‌ای این شرایط را داشته باشد، سیستم این ویژگی را فراخوانی می‌کند:

  • برنامه دارای مشخصه استفاده AudioAttributes.USAGE_MEDIA یا AudioAttributes.USAGE_GAME است.
  • برنامه باموفقیت درخواست تمرکز صوتی کرده است (هرگونه کسب تمرکز) و درحال پخش صدا است.

اگر برنامه‌ای درطول تماس به پخش ادامه دهد، صدای آن تا پایان تماس قطع می‌شود. بااین‌حال، اگر برنامه‌ای درطول تماس شروع به پخش کند، آن پخش‌کننده با این فرض که کاربر پخش را عمداً شروع کرده است، بی‌صدا نمی‌شود.

تمرکز صوتی در Android 8.0 تا Android 11

از Android نسخه ۸.۰ (سطح میانای برنامه‌سازی کاربردی ۲۶) به بعد، وقتی requestAudioFocus() را فراخوانی می‌کنید، باید پارامتر AudioFocusRequest را ارائه دهید. AudioFocusRequest حاوی اطلاعاتی درباره بافت صوتی و قابلیت‌های برنامه‌تان است. سیستم از این اطلاعات برای مدیریت خودکار به‌دست آوردن و ازدست دادن تمرکز صوتی استفاده می‌کند. برای رها کردن تمرکز صوتی، متد abandonAudioFocusRequest() را فراخوانی کنید که AudioFocusRequest را نیز به‌عنوان آرگومان خود می‌گیرد. هم هنگام درخواست و هم هنگام رها کردن تمرکز، از همان نمونه AudioFocusRequest استفاده کنید.

برای ایجاد AudioFocusRequest، از AudioFocusRequest.Builder استفاده کنید. ازآنجایی‌که درخواست تمرکز باید همیشه نوع درخواست را مشخص کند، نوع در سازنده برای سازنده گنجانده شده است. از روش‌های سازنده برای تنظیم فیلدهای دیگر درخواست استفاده کنید.

فیلد FocusGain الزامی است؛ همه فیلدهای دیگر اختیاری هستند.

روشیادداشت‌ها
setFocusGain() این فیلد در هر درخواست الزامی است. این پارامتر همان مقادیر durationHint را می‌گیرد که در فراخوانی requestAudioFocus() در نسخه‌های پیش‌از Android 8.0 استفاده می‌شد: AUDIOFOCUS_GAIN،‏ AUDIOFOCUS_GAIN_TRANSIENT، AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK، یا AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE.
setAudioAttributes() AudioAttributes مورد استفاده برنامه‌تان را شرح می‌دهد. سیستم هنگام به‌دست آوردن و ازدست دادن تمرکز صوتی برنامه، آن‌ها را بررسی می‌کند. مشخصه‌ها جایگزین مفهوم نوع جاری‌سازی می‌شوند. در Android 8.0 (سطح میانای برنامه‌سازی کاربردی ۲۶) و نسخه‌های جدیدتر، انواع جاری‌سازی برای هر عملیاتی غیراز کنترل‌های میزان صدا منسوخ شده است. در درخواست تمرکز، از همان مشخصه‌هایی استفاده کنید که در پخش‌کننده صوتی‌تان استفاده می‌کنید (همان‌طور که در مثال بعداز این جدول نشان داده شده است).

ابتدا از AudioAttributes.Builder برای مشخص کردن مشخصه‌ها استفاده کنید، سپس از این روش برای اختصاص دادن مشخصه‌ها به درخواست استفاده کنید.

اگر مشخص نشده باشد، AudioAttributes به‌طور پیش‌فرض روی AudioAttributes.USAGE_MEDIA تنظیم می‌شود.

setWillPauseWhenDucked() وقتی برنامه دیگری با AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK درخواست تمرکز می‌کند، برنامه‌ای که تمرکز دارد معمولاً onAudioFocusChange() فراخوانی برگشتی دریافت نمی‌کند زیرا سیستم می‌تواند خودش کاهش صدا را انجام دهد. وقتی لازم است به‌جای کاهش صدا، بازپخش را موقتاً متوقف کنید، setWillPauseWhenDucked(true) را فراخوانی کنید و OnAudioFocusChangeListener را ایجاد و تنظیم کنید، همان‌طور که در کاهش خودکار صدا شرح داده شده است.
setAcceptsDelayedFocusGain() درخواست برای تمرکز صوتی ممکن است زمانی که تمرکز توسط برنامه دیگری قفل شده باشد، ناموفق باشد. این روش کسب تمرکز تأخیری را فعال می‌کند: توانایی کسب تمرکز به‌صورت ناهمگام زمانی که دردسترس قرار می‌گیرد.

توجه داشته باشید که کسب تمرکز با تأخیر فقط درصورتی کار می‌کند که AudioManager.OnAudioFocusChangeListener را نیز در درخواست صوتی مشخص کنید، زیرا برنامه‌تان باید فراخوانی متقابل را دریافت کند تا بداند تمرکز اعطا شده است.

setOnAudioFocusChangeListener() OnAudioFocusChangeListener فقط درصورتی لازم است که willPauseWhenDucked(true) یا setAcceptsDelayedFocusGain(true) را نیز در درخواست مشخص کنید.

دو روش برای تنظیم شنونده وجود دارد: یکی با و دیگری بدون آرگومان گرداننده. گرداننده رشته‌ای است که شنونده روی آن اجرا می‌شود. اگر گرداننده‌ای را مشخص نکنید، گرداننده مرتبط با Looper اصلی استفاده می‌شود.

مثال زیر نحوه استفاده از AudioFocusRequest.Builder برای ساختن AudioFocusRequest و درخواست و رها کردن تمرکز صوتی را نشان می‌دهد:

// initializing variables for audio focus and playback management.
audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
focusRequest = AudioFocusRequest.Builder(AudioManager.AUDIOFOCUS_GAIN).run {
    setAudioAttributes(
        AudioAttributes.Builder().run {
            setUsage(AudioAttributes.USAGE_GAME)
            setContentType(AudioAttributes.CONTENT_TYPE_MUSIC)
            build()
        }
    )
    setAcceptsDelayedFocusGain(true)
    setOnAudioFocusChangeListener(afChangeListener, handler)
    build()
}
val focusLock = Any()

var playbackDelayed = false
var playbackNowAuthorized = false

// requesting audio focus and processing the response.
val res = audioManager.requestAudioFocus(focusRequest)
synchronized(focusLock) {
    playbackNowAuthorized = when (res) {
        AudioManager.AUDIOFOCUS_REQUEST_FAILED -> false
        AudioManager.AUDIOFOCUS_REQUEST_GRANTED -> {
            playbackNow()
            true
        }
        AudioManager.AUDIOFOCUS_REQUEST_DELAYED -> {
            playbackDelayed = true
            false
        }
        else -> false
    }
}

// implementing OnAudioFocusChangeListener to react to focus changes.
override fun onAudioFocusChange(focusChange: Int) {
    when (focusChange) {
        AudioManager.AUDIOFOCUS_GAIN ->
            if (playbackDelayed || resumeOnFocusGain) {
                synchronized(focusLock) {
                    playbackDelayed = false
                    resumeOnFocusGain = false
                }
                playbackNow()
            }
        AudioManager.AUDIOFOCUS_LOSS -> {
            synchronized(focusLock) {
                resumeOnFocusGain = false
                playbackDelayed = false
            }
            pausePlayback()
        }
        AudioManager.AUDIOFOCUS_LOSS_TRANSIENT -> {
            synchronized(focusLock) {
                // only resume if playback is being interrupted.
                resumeOnFocusGain = isPlaying()
                playbackDelayed = false
            }
            pausePlayback()
        }
        AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK -> {
            // ... pausing or ducking depends on your app.
        }
    }
}

کاهش خودکار صدای پس‌زمینه

در Android نسخه ۸.۰ (سطح میانای برنامه‌سازی کاربردی ۲۶)، وقتی برنامه دیگری با AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK درخواست تمرکز می‌کند، سیستم می‌تواند بدون فراخوانی کردن فراخوان برگشتی onAudioFocusChange() برنامه، صدا را کاهش دهد و بازیابی کند.

درحالی‌که کاهش خودکار صدا رفتار قابل‌قبولی برای برنامه‌های پخش موسیقی و ویدیو است، هنگام پخش محتوای گفتاری، مانند برنامه کتاب صوتی، مفید نیست. در این حالت، برنامه باید موقتاً متوقف شود.

اگر می‌خواهید برنامه‌تان وقتی از آن خواسته می‌شود صدای خود را کاهش دهد، به‌جای کاهش صدا، موقتاً متوقف شود، یک OnAudioFocusChangeListener با یک روش فراخوانی برگشتی onAudioFocusChange() ایجاد کنید که رفتار توقف/ازسرگیری موردنظر را پیاده‌سازی کند. setOnAudioFocusChangeListener() را برای ثبت شنونده فراخوانی کنید و setWillPauseWhenDucked(true) را فراخوانی کنید تا به سیستم بگویید به‌جای انجام کاهش صدای خودکار، از فراخوانی شما استفاده کند.

تأخیر در تمرکز

گاهی اوقات سیستم نمی‌تواند درخواست تمرکز صوتی را بپذیرد زیرا تمرکز توسط برنامه دیگری «قفل» شده است، مثلاً درطول تماس تلفنی. در این مورد، requestAudioFocus() برمی‌گرداند AUDIOFOCUS_REQUEST_FAILED. وقتی این اتفاق می‌افتد، برنامه شما نباید پخش صدا را ادامه دهد زیرا تمرکز را به‌دست نیاورده است.

روش setAcceptsDelayedFocusGain(true) که به برنامه شما اجازه می‌دهد درخواست تمرکز را به‌صورت ناهمگام مدیریت کند. با تنظیم این پرچم، درخواستی که هنگام قفل بودن فوکوس انجام می‌شود AUDIOFOCUS_REQUEST_DELAYED را برمی‌گرداند. وقتی شرایطی که تمرکز صوتی را قفل کرده بود دیگر وجود نداشته باشد، مثلاً وقتی تماس تلفنی تمام می‌شود، سیستم درخواست تمرکز معلق را اعطا می‌کند و با onAudioFocusChange() تماس می‌گیرد تا به برنامه‌تان اطلاع دهد.

In order to handle the delayed gain of focus, you must create an OnAudioFocusChangeListener with an onAudioFocusChange() callback method that implements the desired behavior and register the listener by calling setOnAudioFocusChangeListener().

تمرکز صوتی در Android 7.1 و نسخه‌های پایین‌تر

وقتی requestAudioFocus() را فراخوانی می‌کنید، باید یک راهنمای مدت‌زمان مشخص کنید که ممکن است توسط برنامه دیگری که درحال‌حاضر تمرکز را حفظ کرده و درحال پخش است، رعایت شود:

  • وقتی قصد دارید صدا را برای آینده قابل‌پیش‌بینی پخش کنید (برای مثال، هنگام پخش موسیقی) و انتظار دارید دارنده قبلی تمرکز صوتی پخش را متوقف کند، تمرکز صوتی دائمی (AUDIOFOCUS_GAIN) درخواست کنید.
  • وقتی انتظار دارید صدا را فقط برای مدت کوتاهی پخش کنید و انتظار دارید دارنده قبلی پخش را موقتاً متوقف کند، درخواست تمرکز گذرا (AUDIOFOCUS_GAIN_TRANSIENT) کنید.
  • با کاهش موقت صدا (AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK) درخواست تمرکز گذرا کنید تا نشان دهید که انتظار دارید صدا را فقط برای مدت کوتاهی پخش کنید و اشکالی ندارد که مالک تمرکز قبلی به پخش ادامه دهد، به‌شرطی که خروجی صدای خود را «کاهش موقت» دهد (کم کند). هر دو خروجی صوتی در جاری‌سازی صوتی مخلوط می‌شوند. کاهش موقت صدا به‌ویژه برای برنامه‌هایی مناسب است که به‌طور متناوب از جاری‌سازی صوتی استفاده می‌کنند، مانند مسیرهای رانندگی شنیداری.

روش requestAudioFocus() به AudioManager.OnAudioFocusChangeListener نیز نیاز دارد. این شنونده باید در همان فعالیت یا سرویسی ایجاد شود که مالک جلسه رسانه شما است. این کلاس فراخوانی برگشتی onAudioFocusChange() را پیاده‌سازی می‌کند که برنامه شما هنگام کسب یا رها کردن تمرکز صوتی توسط برنامه دیگری دریافت می‌کند.

قطعه کد زیر درخواست تمرکز صوتی دائمی روی جاری‌سازی STREAM_MUSIC می‌کند و یک OnAudioFocusChangeListener را برای مدیریت تغییرات بعدی در تمرکز صوتی ثبت می‌کند. (شنونده تغییر در پاسخ دادن به تغییر تمرکز صوتی بحث شده است.)

audioManager = getSystemService(Context.AUDIO_SERVICE) as AudioManager
lateinit var afChangeListener: AudioManager.OnAudioFocusChangeListener

// ...
// Request audio focus for playback.
val result: Int = audioManager.requestAudioFocus(
    afChangeListener,
    // Use the music stream.
    AudioManager.STREAM_MUSIC,
    // Request permanent focus.
    AudioManager.AUDIOFOCUS_GAIN
)

if (result == AudioManager.AUDIOFOCUS_REQUEST_GRANTED) {
    // Start playback.
}

وقتی بازپخش تمام شد، abandonAudioFocus() را فراخوانی کنید.

audioManager.abandonAudioFocus(afChangeListener)

این کار به سیستم اطلاع می‌دهد که دیگر به تمرکز نیاز ندارید و OnAudioFocusChangeListener مربوطه را لغو ثبت می‌کند. اگر درخواست تمرکز گذرا کرده باشید، این کار به برنامه‌ای که موقتاً متوقف شده یا صدای آن کاهش یافته است اطلاع می‌دهد که می‌تواند به پخش ادامه دهد یا صدایش را بازیابی کند.

پاسخ دادن به تغییر تمرکز صوتی

وقتی برنامه‌ای تمرکز صوتی را به‌دست می‌آورد، باید بتواند آن را زمانی که برنامه دیگری درخواست تمرکز صوتی برای خود می‌کند، رها کند. وقتی این اتفاق می‌افتد، برنامه شما تماسی با روش onAudioFocusChange() در AudioFocusChangeListener که هنگام تماس برنامه با requestAudioFocus() مشخص کرده‌اید دریافت می‌کند.

پارامتر focusChange که به onAudioFocusChange() منتقل شده است نشان‌دهنده نوع تغییری است که درحال رخ دادن است. این مقدار با راهنمای مدت استفاده‌شده توسط برنامه‌ای که تمرکز را به‌دست می‌آورد مطابقت دارد. برنامه‌تان باید به‌طور مناسب پاسخ دهد.

ازدست دادن موقت تمرکز
اگر تغییر تمرکز گذرا باشد (AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK یا AUDIOFOCUS_LOSS_TRANSIENT)، برنامه شما باید صدا را کاهش دهد (اگر به کاهش خودکار صدا متکی نیستید) یا پخش را موقتاً متوقف کند، اما درغیراین‌صورت همان وضعیت را حفظ کند.

درطول ازدست رفتن موقت تمرکز صوتی، باید همچنان تغییرات تمرکز صوتی را پایش کنید و آماده باشید تا وقتی تمرکز را دوباره به‌دست آوردید، بازپخش عادی را ازسر بگیرید. وقتی برنامه مسدودکننده تمرکز را رها می‌کند، یک فراخوانی برگشتی دریافت می‌کنید (AUDIOFOCUS_GAIN). در این مرحله، می‌توانید میزان صدا را به سطح عادی برگردانید یا بازپخش را بازراه‌اندازی کنید.

ازدست دادن دائمی تمرکز
اگر ازدست رفتن تمرکز صوتی دائمی باشد (AUDIOFOCUS_LOSS)، برنامه دیگری درحال پخش صدا است. برنامه‌تان باید فوراً بازپخش را موقتاً متوقف کند، زیرا هرگز فراخوان AUDIOFOCUS_GAIN را دریافت نخواهد کرد. برای بازراه‌اندازی بازپخش، کاربر باید کنش صریحی انجام دهد، مثلاً فشار دادن کنترل انتقال پخش در اعلان یا میانای کاربر برنامه.

تکه‌کد زیر نحوه پیاده‌سازی OnAudioFocusChangeListener و فراخوان برگشتی onAudioFocusChange() آن را نشان می‌دهد. به استفاده از Handler برای به‌تأخیر انداختن فراخوانی توقف درصورت ازدست رفتن دائمی تمرکز صوتی توجه کنید.

private val handler = Handler(Looper.getMainLooper())
private val afChangeListener = AudioManager.OnAudioFocusChangeListener { focusChange ->
    when (focusChange) {
        AudioManager.AUDIOFOCUS_LOSS -> {
            // Permanent loss of audio focus.
            // Pause playback immediately.
            mediaController.transportControls.pause()
            // Wait 30 seconds before stopping playback.
            handler.postDelayed(delayedStopRunnable, TimeUnit.SECONDS.toMillis(30))
        }
        AudioManager.AUDIOFOCUS_LOSS_TRANSIENT -> {
            // Pause playback.
        }
        AudioManager.AUDIOFOCUS_LOSS_TRANSIENT_CAN_DUCK -> {
            // Lower the volume, keep playing.
        }
        AudioManager.AUDIOFOCUS_GAIN -> {
            // Your app has been granted audio focus again.
            // Raise volume to normal, restart playback if necessary.
        }
    }
}

گرداننده از Runnable استفاده می‌کند که به این شکل است:

private var delayedStopRunnable = Runnable {
    mediaController.transportControls.stop()
}

برای اطمینان از اینکه اگر کاربر بازپخش را بازراه‌اندازی کرد، توقف با تأخیر شروع نشود، mHandler.removeCallbacks(mDelayedStopRunnable) را در پاسخ به هرگونه تغییر وضعیت فراخوانی کنید. برای مثال، removeCallbacks() را در onPlay()، onSkipToNext()، و غیره «بازخوانی» خود فراخوانی کنید. همچنین باید این روش را در بازخوانی onDestroy() سرویس خود هنگام پاک‌سازی منابع استفاده‌شده توسط سرویس فراخوانی کنید.