অডিও নিয়ন্ত্রণ HAL

অডিও নিয়ন্ত্রণ HAL স্বয়ংচালিত প্রাসঙ্গিক অডিও ব্যবহারের ক্ষেত্রে সমর্থন করার জন্য Android 9 এ চালু করা হয়েছিল। অ্যান্ড্রয়েড 14 অনুসারে, অডিও নিয়ন্ত্রণ HAL সমর্থন করে:

  • বিবর্ণ এবং ভারসাম্য
  • HAL অডিও ফোকাস অনুরোধ
  • ডিভাইস নিঃশব্দ এবং হাঁস
  • অডিও ডিভাইস লাভ পরিবর্তন
  • অডিও পোর্ট কনফিগারেশন পরিবর্তন

চিত্র 1 গাড়ির অডিও পরিষেবা আর্কিটেকচারের একটি উচ্চ-স্তরের ওভারভিউ দেখায়, যেখানে গাড়ি অডিও পরিষেবা অডিও নিয়ন্ত্রণ HAL-এর সাথে যোগাযোগ করে।

মাল্টি-জোন অডিও কনফিগার করুন

চিত্র 1. মাল্টি-জোন অডিও কনফিগার করুন।

অডিও ফেইড এবং ব্যালেন্স

HIDL অডিও কন্ট্রোল HAL সংস্করণ 1 স্বয়ংচালিত ব্যবহারের ক্ষেত্রে অডিও ফেইড এবং ভারসাম্য সমর্থন করার জন্য Android 9 এ চালু করা হয়েছিল। অ্যান্ড্রয়েডে ইতিমধ্যেই দেওয়া জেনেরিক অডিও প্রভাবগুলি থেকে আলাদা, এই পদ্ধতিটি সিস্টেম অ্যাপগুলিকে অডিও ব্যালেন্স সেট করতে এবং CarAudioManager API-এর মাধ্যমে বিবর্ণ করার অনুমতি দেয়:

class CarAudioManager {
       /**
       *   Adjust the relative volume in the front vs back of the vehicle cabin.
       *
       *   @param value in the range -1.0 to 1.0 for fully toward the back through
       *   fully toward the front. 0.0 means evenly balanced.
       */
       @SystemApi
       @RequiresPermission(Car.PERMISSION_CAR_CONTROL_AUDIO_VOLUME)
       public void setFadeTowardFront(float value);

       /**
       *   Adjust the relative volume on the left vs right side of the vehicle cabin.
       *
       *   @param value in the range -1.0 to 1.0 for fully toward the left through
       *   fully toward the right. 0.0 means evenly balanced.
       */
       @SystemApi
       @RequiresPermission(Car.PERMISSION_CAR_CONTROL_AUDIO_VOLUME)
       public void setBalanceTowardRight(float value);
}

একবার এই APIগুলি কল করা হলে, সংশ্লিষ্ট অডিও কন্ট্রোল HAL APIগুলিকে গাড়ির অডিও পরিষেবা থেকে কল করা হয়:

interface IAudioControl {
       /**
       *   Control the right/left balance setting of the car speakers.
       */
       oneway setBalanceTowardRight(float value);

       /**
       *   Control the fore/aft fade setting of the car speakers.
       */
       oneway setFadeTowardFront(float value);
}

নতুন AIDL HAL ইন্টারফেস সহ অডিও কন্ট্রোল HAL-এর সমস্ত সংস্করণে API উপলব্ধ।

HAL থেকে অডিও ফোকাস অনুরোধ

AAOS, Android এর মতো, গাড়িতে অডিও প্লেব্যাক পরিচালনা করতে অডিও ফোকাসে অ্যাপগুলির সক্রিয় অংশগ্রহণের উপর নির্ভর করে। ভলিউম এবং হাঁসের জন্য কোন স্ট্রীম নিয়ন্ত্রণ করতে হবে তা পরিচালনা করতে ফোকাস তথ্য ব্যবহার করা হয়। যেমন, অডিও ফোকাসকে আরও প্রসারিত করতে এবং অ্যান্ড্রয়েড অভিজ্ঞতায় গাড়ির নির্দিষ্ট শব্দগুলির আরও ভাল একীকরণ প্রদান করতে, Android 11-এ নিম্নলিখিত অডিও বৈশিষ্ট্যগুলি চালু করা হয়েছিল:

  • EMERGENCY
  • SAFETY
  • VEHICLE_STATUS
  • ANNOUNCEMENT

এই পরিবর্তনের পাশাপাশি, অডিও ফোকাস অনুরোধে অংশ নেওয়ার জন্য বাইরের Android থেকে উদ্ভূত শব্দগুলির জন্য একটি প্রক্রিয়া যুক্ত করা হয়েছিল৷ সুতরাং, এইচআইডিএল অডিও কন্ট্রোল এইচএএল সংস্করণ 2 চালু করা হয়েছিল যাতে ফোকাস অনুরোধগুলি অ্যানড্রয়েডের বাইরে থেকে আসে:

interface IAudioControl {
       /**
       *   Registers focus listener to be used by HAL for requesting and
       *   abandoning audio focus.
       *   @param listener the listener interface
       *   @return closeHandle A handle to unregister observer.
       */
       registerFocusListener(IFocusListener listener)
       generates (ICloseHandle closeHandle);

       /**
       *   Notifies HAL of changes in audio focus status for focuses requested
       *   or abandoned by the HAL.
       *
       *   @param usage The audio usage associated with the focus change
       *   @param zoneId The identifier for the audio zone that the HAL is
       *   playing the stream in
       *   @param focusChange the AudioFocusChange that has occurred
       */
       oneway onAudioFocusChange(bitfield<AudioUsage> usage, int32_t zoneId,
       bitfield<AudioFocusChange> focusChange);
}

যেখানে IFocusListener হিসাবে সংজ্ঞায়িত করা হয়:

interface IFocusListener {
       /**
       *   Called whenever HAL is requesting focus as it is starting to play
       *   audio of a given usage in a specified zone.
       *
       *   @param usage The audio usage associated with the focus request
       *    {@code AttributeUsage}
       *   @param zoneId The identifier for the audio zone where the HAL is
       *    requesting focus
       *   @param focusGain The AudioFocusChange associated with this request.
       */
       oneway requestAudioFocus(bitfield<AudioUsage> usage,
       int32_t zoneId, bitfield<AudioFocusChange> focusGain);
       /**
       *   Called whenever HAL is abandoning focus as it is finished playing audio
       *   of a given usage in a specific zone.
       *
       *   @param usage The audio usage for which the HAL is abandoning focus
       *    {@code AttributeUsage}
       *   @param zoneId The identifier for the audio zone that the HAL
       *    abandoning focus
       */
       oneway abandonAudioFocus(bitfield<AudioUsage> usage, int32_t zoneId);
}

উপরের APIগুলি যথাক্রমে HAL থেকে অডিও ফোকাস অনুরোধ এবং পরিত্যাগ করতে ব্যবহার করা যেতে পারে। প্রতিক্রিয়া হিসাবে, গাড়ী অডিও পরিষেবা অডিও ফোকাস অনুরোধ বিবেচনা করে এবং ফলাফলগুলিকে অসিঙ্ক্রোনাসভাবে IAudioControl#onAudioFocusChange পদ্ধতিতে ফরোয়ার্ড করে।

এই APIটি অডিও নিয়ন্ত্রণ HAL থেকে উদ্ভূত অডিও ফোকাস অনুরোধের পরিবর্তনগুলি নিরীক্ষণ করতেও ব্যবহার করা যেতে পারে। সাধারণভাবে, HAL-এর তরফ থেকে যেকোনো স্থায়ী অডিও ফোকাস অনুরোধ সক্রিয় বলে বিবেচিত হয়, যা অ্যান্ড্রয়েডের একটি অডিও ফোকাস অনুরোধের থেকে আলাদা, যেখানে শুধুমাত্র একটি সংশ্লিষ্ট সক্রিয় অডিও ট্র্যাক প্লেব্যাক সক্রিয় হিসাবে বিবেচিত হয়।

HIDL থেকে AIDL অডিও কন্ট্রোল HAL-এ স্থানান্তর করুন

AIDL-এর আবির্ভাব এবং Android 12-এ প্রয়োজনীয় স্থানান্তর (আরও জানতে, HAL-এর জন্য AIDL দেখুন), অডিও নিয়ন্ত্রণ HAL-কে AIDL-এ স্থানান্তরিত করা হয়েছিল। বিদ্যমান HIDL অডিও কন্ট্রোল সংস্করণ 2 API-এর জন্য, মাইগ্রেশনের জন্য বিদ্যমান পদ্ধতিগুলিতে ছোটখাটো আপডেটের প্রয়োজন:

interface IAudioControl {
       /**
       *   Notifies HAL of changes in audio focus status for focuses requested
       *   or abandoned by the HAL.
       *
       *   @param usage The audio usage associated with the focus change
       *        {@code AttributeUsage}. See {@code audioUsage} in
       *        audio_policy_configuration.xsd for the list of allowed values.
       *   @param zoneId The identifier for the audio zone that the HAL is
       *        playing the stream in
       *   @param focusChange the AudioFocusChange that has occurred.
       */
       oneway void onAudioFocusChange(in String usage, in int zoneId,
              in AudioFocusChange focusChange);
       /**
       *   Registers focus listener to be used by HAL for requesting and
       *   abandoning audio focus.
       *   @param listener the listener interface.
       */
       oneway void registerFocusListener(in IFocusListener listener);
       /**
       *   Control the right/left balance setting of the car speakers.
       */
       oneway void setBalanceTowardRight(in float value);
       /**
       *   Control the fore/aft fade setting of the car speakers.
       */
       oneway void setFadeTowardFront(in float value);
}

এবং সংশ্লিষ্ট IFocusListener :

       interface IFocusListener {
       /**
       *   Called whenever HAL is abandoning focus as it is finished playing audio
       *   of a given usage in a specific zone.
       *
       *   @param usage The audio usage for which the HAL is abandoning focus
       *        {@code AttributeUsage}. See {@code audioUsage} in
       *        audio_policy_configuration.xsd for the list of allowed values.
       *   @param zoneId The identifier for the audio zone that the HAL
       *        abandoning focus
       */
       oneway void abandonAudioFocus(in String usage, in int zoneId);
       /**
       *   Called whenever HAL is requesting focus as it is starting to play audio
       *        of a given usage in a specified zone.
       *
       *   @param usage The audio usage associated with the focus request
       *        {@code AttributeUsage}. See {@code audioUsage} in
       *        audio_policy_configuration.xsd for the list of allowed values.
       *   @param zoneId The identifier for the audio zone where the HAL is
       *        requesting focus
       *   @param focusGain The AudioFocusChange associated with this request.
       */
       oneway void requestAudioFocus(in String usage, in int zoneId,
              in AudioFocusChange focusGain);
}

ভলিউম গ্রুপ নিঃশব্দ

অ্যান্ড্রয়েড 12 ব্যবহারকারীর অডিও ইন্টারঅ্যাকশনের সময় আরও ব্যাপক নিঃশব্দ নিয়ন্ত্রণের অনুমতি দেওয়ার জন্য ভলিউম গ্রুপ মিউটিং চালু করেছে। এটি অডিও কন্ট্রোল এইচএএলকে গাড়ির অডিও পরিষেবা দ্বারা বাধাপ্রাপ্ত মিউটিং ইভেন্টগুলি গ্রহণ করার অনুমতি দেয়।

বৈশিষ্ট্যটি সক্ষম করার জন্য, OEM-গুলিকে অবশ্যই গাড়ি পরিষেবা config.xml এ audioUseCarVolumeGroupMuting কনফিগারেশন true হিসাবে সেট করতে হবে :

<!-- Configuration to enable muting of individual volume groups.
If this is set to false, muting of individual volume groups is disabled,
instead muting will toggle master mute. If this is set to true, car volume
group muting is enabled and each individual volume group can be muted separately. -->
<bool name="audioUseCarVolumeGroupMuting">true</bool>

Android 13 এর আগে, packages/services/Car/service/res/values/config.xml এর জন্য রানটাইম রিসোর্স ওভারলে দিয়ে কনফিগারেশনকে ওভাররাইট করতে হতো (আরো জানতে, রিসোর্স ওভারলে দিয়ে বিল্ড কাস্টমাইজ করা দেখুন)। Android 13 থেকে, আপনি কনফিগারেশন মান পরিবর্তন করতে রানটাইম রিসোর্স ওভারলে ব্যবহার করতে পারেন। আরও জানতে, রানটাইমে অ্যাপের সম্পদের মান পরিবর্তন দেখুন।

সিস্টেম অ্যাপগুলি CarAudioManager#isAudioFeatureEnabled API ব্যবহার করে বৈশিষ্ট্যটি সক্ষম কিনা তা নির্ধারণ করতে পারে৷ পাস করা প্যারামিটারটি অবশ্যই CarAudioManager.AUDIO_FEATURE_VOLUME_GROUP_MUTING হতে হবে।AUDIO_FEATURE_VOLUME_GROUP_MUTING ধ্রুবক। বৈশিষ্ট্যটি ডিভাইসে সক্রিয় থাকলে পদ্ধতিটি true হয়ে যায়, অন্যথায় false ।

audioUseCarVolumeGroupMuting বৈশিষ্ট্য সক্রিয় করার পাশাপাশি, AIDL অডিও কন্ট্রোল HAL-কে অবশ্যই ভলিউম গ্রুপ মিউট করার পদ্ধতি প্রয়োগ করতে হবে:

interface IAudioControl {
       /**
       *   Notifies HAL of changes in output devices that the HAL should apply
       *   muting to.
       *
       *   This will be called in response to changes in audio mute state for each
       *   volume group and will include a {@link MutingInfo} object per audio
       *   zone that experienced a mute state event.
       *
       *   @param mutingInfos an array of {@link MutingInfo} objects for the audio
       *   zones where audio mute state has changed.
       */
       oneway void onDevicesToMuteChange(in MutingInfo[] mutingInfos);
}

যেখানে মিউট করার তথ্যে অডিও সিস্টেমের জন্য প্রাসঙ্গিক নিঃশব্দ তথ্য থাকে:

parcelable MutingInfo {
       /**
       *   ID of the associated audio zone
       */
       int zoneId;
       /**
       *   List of addresses for audio output devices that should be muted.
       */
       String[] deviceAddressesToMute;
       /**
       *   List of addresses for audio output devices that were previously be
       *   muted and should now be unmuted.
       */
       String[] deviceAddressesToUnmute;
}

AAOS এর নিঃশব্দ করার জন্য দুটি ভিন্ন প্রক্রিয়া রয়েছে, এর উপর ভিত্তি করে:

  • KEYCODE_VOLUME_MUTE {:.external} অডিও ব্যবহার করে মূল ঘটনা।

  • কার অডিও ম্যানেজার মিউট API, CarAudioManager#setVolumeGroupMute ব্যবহার করে গাড়ির অডিও পরিষেবাতে সরাসরি কল।

সক্রিয় করা হলে, উভয় প্রক্রিয়াই অডিও কন্ট্রোল HAL-এ একটি কল মিউট ট্রিগার করে।

গাড়ী অডিও হাঁস

অ্যান্ড্রয়েড 12 অডিও স্ট্রিমগুলির সমসাময়িক প্লেব্যাকের নিয়ন্ত্রণকে অপ্টিমাইজ করতে কার অডিও ডাকিং চালু করেছে। এটি গাড়ির অডিও পরিষেবা দ্বারা নির্ধারিত গাড়ির শারীরিক অডিও কনফিগারেশন এবং বর্তমান প্লেব্যাকের অবস্থার উপর ভিত্তি করে OEM-গুলিকে তাদের নিজস্ব হাঁসের আচরণ বাস্তবায়ন করতে দেয়৷

ডাকিং মেকানিজম অডিও ফোকাস স্ট্যাক পরিবর্তনের উপর ভিত্তি করে। যখনই একটি ফোকাস পরিবর্তন ঘটে (ফোকাস অনুরোধ হোক বা ফোকাস পরিত্যাগ করা হোক), অডিও কন্ট্রোল HAL-কে জানানো হয়। গাড়ির ভলিউম গ্রুপ মিউটিং সমর্থনের মতো, অডিও audioUseHalDuckingSignals কনফিগারেশন পতাকা দিয়ে গাড়ির অডিও ডাকিং সক্ষম করা যেতে পারে:

<!-- Configuration to enable IAudioControl#onDevicesToDuckChange API to
inform HAL when to duck. If this is set to true, the API will receive signals
indicating which output devices to duck as well as what usages are currently
holding focus. If set to false, the API will not be called. -->
<bool name="audioUseHalDuckingSignals">true</bool>

বৈশিষ্ট্যটি সক্ষম করতে, AIDL অডিও কন্ট্রোল HAL-কে অবশ্যই গাড়ির অডিও পরিষেবা থেকে প্রাপ্ত সংকেত সহ প্রাসঙ্গিক যুক্তি প্রয়োগ করতে হবে:

interface IAudioControl {
       /**
       *   Notifies HAL of changes in output devices that the HAL should apply
       *   ducking to.
       *
       *   This will be called in response to changes in audio focus, and will
       *   include a {@link DuckingInfo} object per audio zone that experienced
       *   a change in audo focus.
       *
       *   @param duckingInfos an array of {@link DuckingInfo} objects for the
       *   audio zones where audio focus has changed.
       */
       oneway void onDevicesToDuckChange(in DuckingInfo[] duckingInfos);
}

প্রাসঙ্গিক অডিও সিস্টেমের তথ্য অডিও ডাকিং তথ্যের মধ্যে রয়েছে:

parcelable DuckingInfo {
       /**
       *   ID of the associated audio zone
       */
       int zoneId;
       /**
       *   List of addresses for audio output devices that should be ducked.
       */
       String[] deviceAddressesToDuck;
       /**
       *   List of addresses for audio output devices that were previously be
       *   ducked and should now be unducked.
       */
       String[] deviceAddressesToUnduck;
       /**
       *   List of usages currently holding focus for this audio zone.
       */
       String[] usagesHoldingFocus;
}

গাড়ির অডিও কনফিগারেশন তথ্য ছাড়াও (আন) হাঁসের ডিভাইসের ঠিকানায়, হাঁসের তথ্যে কোন অডিও অ্যাট্রিবিউটের ব্যবহার ফোকাস ধরে আছে সে সম্পর্কেও তথ্য রয়েছে। এই ডেটার উদ্দেশ্য হল অডিও সিস্টেমকে জানানো যে কোন অডিও অ্যাট্রিবিউটের ব্যবহার সক্রিয়।

এটি প্রয়োজনীয় কারণ, গাড়ির অডিও কনফিগারেশনে, একাধিক অডিও বৈশিষ্ট্য একটি একক ডিভাইসে বরাদ্দ করা যেতে পারে এবং অতিরিক্ত তথ্য ছাড়া, কোন ব্যবহার সক্রিয় তা স্পষ্ট নয়।

AIDL অডিও কন্ট্রোল HAL 2.0

API আপডেট করতে এবং নতুন কার্যকারিতা সহজতর করার জন্য, AIDL অডিও কন্ট্রোল HAL-কে Android 13-এর সংস্করণ 2.0-এ আপডেট করা হয়েছে:

  • PlaybackTrackMetadata সহ অডিও ফোকাস
  • অডিও লাভ কলব্যাক

প্লেব্যাক মেটাডেটা android.hardware.audio.common এ নিম্নরূপ সংজ্ঞায়িত করা হয়েছে:

parcelable PlaybackTrackMetadata {
       AudioUsage usage = INVALID;
       AudioContentType contentType = UNKNOWN;
       float gain;
       AudioChannelLayout channelMask;
       AudioDevice sourceDevice;
       String[] tags;
}

AIDL অডিও কন্ট্রোল সংস্করণ 1.0 থেকে অন্যান্য সমস্ত কার্যকারিতা রয়ে গেছে এবং ব্যবহার করা যেতে পারে। একটি ব্যতিক্রম অডিও ফোকাস পরিবর্তন পদ্ধতির সাথে সম্পর্কিত, যেমন অডিও ফোকাস পরিবর্তন পদ্ধতিতে বর্ণিত হয়েছে।

প্লেব্যাক ট্র্যাক মেটাডেটা সহ অডিও নিয়ন্ত্রণ ফোকাস

HAL-এর নীচের অডিও সিস্টেমে আরও তথ্য প্রকাশ করতে, আপডেটগুলি এখন PlaybackTrackMetadata প্রকাশ করে। বিশেষত, অডিও কন্ট্রোল HAL একটি নতুন পদ্ধতির সাথে প্রসারিত করা হয়েছিল:

interface IAudioControl {
       /**
       *   Notifies HAL of changes in audio focus status for focuses requested
       *   or abandoned by the HAL.
       *
       *   The HAL is not required to wait for a callback of AUDIOFOCUS_GAIN
       *   before playing audio, nor is it required to stop playing audio in the
       *   event of a AUDIOFOCUS_LOSS callback is received.
       *
       *   @param playbackMetaData The output stream metadata associated with
       *    the focus request
       *   @param zoneId The identifier for the audio zone that the HAL is
       *    playing the stream in
       *   @param focusChange the AudioFocusChange that has occurred.
       */
       oneway void onAudioFocusChangeWithMetaData(
       in PlaybackTrackMetadata playbackMetaData, in int zoneId,
       in AudioFocusChange focusChange);
}

IFocusListener এ একটি অনুরূপ, সংশ্লিষ্ট, পরিবর্তন করা হয়েছে:

       /**
       *   Called to indicate that the audio output stream associated with
       *   {@link android.hardware.audio.common.PlaybackTrackMetadata} is
       *   abandoning focus as playback has stopped.
       *
       *   @param playbackMetaData The output stream metadata associated with
       *    the focus request
       *   @param zoneId The identifier for the audio zone that the HAL
       *    abandoning focus
       */
       oneway void abandonAudioFocusWithMetaData(
       in PlaybackTrackMetadata playbackMetaData, in int zoneId);
       /**
       *   Called to indicate that the audio output stream associated with
       *   {@link android.hardware.audio.common.PlaybackTrackMetadata} has taken
       *   the focus as playback is starting for the corresponding stream.
       *
       *   @param playbackMetaData The output stream metadata associated with
       *    the focus request
       *   @param zoneId The identifier for the audio zone that the HAL
       *    abandoning focus
       *   @param focusGain The focus type requested.
       */
       oneway void requestAudioFocusWithMetaData(
       in PlaybackTrackMetadata playbackMetaData, in int zoneId,
       in AudioFocusChange focusGain);
}

অডিও ফোকাস পরিবর্তন পদ্ধতি

উপরের ফোকাস অপারেশনগুলি HAL থেকে অডিও ফোকাস অনুরোধে বর্ণিত হিসাবে একইভাবে সম্পাদন করে। শুধুমাত্র প্লেব্যাক ট্র্যাক মেটাডেটাতে অডিও অ্যাট্রিবিউটের ব্যবহার সহ আরও তথ্য রয়েছে৷ সাধারণভাবে, প্লেব্যাক ট্র্যাক মেটাডেটা দ্বারা প্রদত্ত অতিরিক্ত তথ্যের প্রয়োজন না হলে, আপডেট করা অ্যান্ড্রয়েড নিয়ন্ত্রণ HAL পূর্ববর্তী পদ্ধতিগুলি ব্যবহার করা চালিয়ে যেতে পারে।

যদি HAL ডেভেলপাররা IAudioControl#onAudioFocusChangeWithMetaData সমর্থন না করার সিদ্ধান্ত নেয়, তবে পদ্ধতিটি UNKNOWN_TRANSACTION ত্রুটির সাথে ফলাফল প্রদান করবে যেমন বর্ণনা করা হয়েছে সংস্করণযুক্ত ইন্টারফেস পদ্ধতি ব্যবহার করে ।

অডিও পরিষেবাটি প্রথমে কল করে onAudioFocusChangeWithMetaData এবং তারপরে UNKNOWN_TRANSACTION ব্যর্থ হলে onAudioFocusChange পদ্ধতিতে পুনরায় চেষ্টা করে৷

প্লেব্যাক ট্র্যাক মেটাডেটা সহ গাড়ী অডিও হাঁস

AIDL অডিও কন্ট্রোল HAL এর সংস্করণ 2.0 অডিও ডাকিং তথ্যে প্লেব্যাক ট্র্যাক মেটাডেটা যোগ করেছে:

parcelable DuckingInfo {
       /**
       *   ID of the associated audio zone
       */
       int zoneId;
       /**
       *   List of addresses for audio output devices that should be ducked.
       */
       String[] deviceAddressesToDuck;
       /**
       *   List of addresses for audio output devices that were previously be
       *   ducked and should now be unducked.
       */
       String[] deviceAddressesToUnduck;
       /**
       *   List of usages currently holding focus for this audio zone.
       */
       String[] usagesHoldingFocus;
       /**
       *   List of output stream metadata associated with the current focus
       *   holder for this audio zone
       */
       @nullable PlaybackTrackMetadata[] playbackMetaDataHoldingFocus;
}

usagesHoldingFocus বাতিল করা হয়েছে। অডিও অ্যাট্রিবিউট ব্যবহার এবং অন্যান্য অডিও তথ্য নির্ধারণ করতে ডেভেলপারদের এখন playbackMetaDataHoldingFocus ব্যবহার করা উচিত। এটি বলেছে, এই বিকল্পটি আনুষ্ঠানিকভাবে সরানো না হওয়া পর্যন্ত usagesHoldingFocus প্যারামিটারে এখনও প্রয়োজনীয় তথ্য রয়েছে।

অডিও লাভ কলব্যাক

অ্যান্ড্রয়েড 13-এ AAOS-এর কাছে HAL-এর নীচের অডিও পরিবর্তনগুলি আরও দৃশ্যমান করার জন্য, আমরা একটি প্রক্রিয়া যুক্ত করেছি যা আপনি গাড়ির অডিও সিস্টেম থেকে গাড়ির অডিও পরিষেবাতে অডিও লাভের পরিবর্তনগুলিকে যোগাযোগ করতে ব্যবহার করতে পারেন৷ মেকানিজম অডিও লাভ ভলিউম সূচকের পরিবর্তনগুলি প্রকাশ করে যে কারণে লাভ পরিবর্তন করা হয়েছিল:

  • অবরুদ্ধ বা নিঃশব্দ সীমাবদ্ধতা
  • সীমাবদ্ধতা সীমাবদ্ধতা
  • মনোযোগ নিষেধাজ্ঞা

এই পরিবর্তনগুলি HAL-এর নীচে থেকে গাড়ির অডিও পরিষেবা এবং অবশেষে, ব্যবহারকারীকে জানানোর জন্য একটি সিস্টেম UI অ্যাপে এই বিধিনিষেধগুলি প্রকাশ করে৷ পরবর্তী অংশ, একটি সম্ভাব্য সিস্টেম UI এর এক্সপোজার, Android 14-এ আরও প্রসারিত করা হয়েছিল যাতে সিস্টেম UI অ্যাপগুলি ভলিউম গ্রুপ ইনফরমেশন কলব্যাক মেকানিজমের মাধ্যমে আরও সহজে এই তথ্য পেতে পারে।

অডিও কন্ট্রোল HAL API নিম্নরূপ লাভ কলব্যাক নিবন্ধন করে:

interface IAudioControl {
       /**
       *   Registers callback to be used by HAL for reporting unexpected gain(s)
       *    changed and the reason(s) why.
       *
       *   @param callback The {@link IAudioGainCallback}.
       */
       oneway void registerGainCallback(in IAudioGainCallback callback);
}

IAudioGainCallback নিম্নরূপ সংজ্ঞায়িত করা হয়েছে:

interface IAudioGainCallback {
       /**
       *   Used to indicate that one or more audio device port gains have changed,
       *   i.e. initiated by HAL, not by CarAudioService.
       *   This is the counter part of the
       *   {@link onDevicesToDuckChange}, {@link onDevicesToMuteChange} and,
       *   {@link setAudioDeviceGainsChanged} APIs.
       *
       *   @param reasons List of reasons that triggered the given gains changed.
       *   @param gains List of gains affected by the change.
       */
       void onAudioDeviceGainsChanged(in Reasons[] reasons,
       in AudioGainConfigInfo[] gains);
}

API ডকুমেন্টেশনে যেমন হাইলাইট করা হয়েছে, গেইন কলব্যাক গাড়ি অডিও পরিষেবা দ্বারা অডিও কন্ট্রোল HAL-এ নিবন্ধিত হয়। যখন অডিও কন্ট্রোল এইচএএল থেকে এপিআই কল করা হয়, তখন গাড়ির অডিও পরিষেবা একটি সংশ্লিষ্ট অ্যাকশন (যেমন ব্লক, লিমিট বা অ্যাটেনুয়েট গেইন ইনডেক্স) দিয়ে সাড়া দেয়।

এইচএএল নির্ধারণ করে কখন এপিআই কল করা হবে, প্রাথমিকভাবে লাভ সূচকের অবস্থার পরিবর্তনের রিপোর্ট করার জন্য। প্রবিধানের প্রয়োজনীয়তাগুলির জন্য নির্দিষ্ট, গাড়ির অডিও সিস্টেমের প্রয়োজনীয় ব্যবস্থা নেওয়া উচিত এবং ব্যবহারকারীর ব্যবহারের অনুমতি দেওয়ার জন্য গাড়ির অডিও পরিষেবাতে তথ্য প্রতিবেদন করতে কলব্যাক ব্যবহার করা উচিত। উদাহরণস্বরূপ, ব্যবহারকারীকে একটি UI দেখাতে।

AIDL অডিও কন্ট্রোল HAL 3.0

Android 14 AIDL অডিও কন্ট্রোল HAL সংস্করণটি আরও শক্তিশালী অডিও লাভ সূচক কার্যকারিতা প্রদানের জন্য API গুলি আপডেট করতে সংস্করণ 3.0 এ আপডেট করা হয়েছে। অডিও কন্ট্রোল HAL API অডিও পরিষেবাকে একটি IModuleChangeCallback সেট এবং আনসেট করার অনুমতি দেয়:

interface IAudioControl {
       /**
       *   Sets callback with HAL for notifying changes to hardware module
       *   (that is: {@link android.hardware.audio.core.IModule}) configurations.
       *
       *   @param callback The {@link IModuleChangeCallback} interface to use
       *    use when new updates are available for
       */
       void setModuleChangeCallback(in IModuleChangeCallback callback);
       /**
       *   Clears module change callback
       */
       void clearModuleChangeCallback();
}

setModuleChangeCallback গাড়ির অডিও পরিষেবা দ্বারা নিবন্ধিত হয় যখন পরিষেবাটি শুরু হয় বা যখন কোনও ত্রুটি থেকে পুনরুদ্ধার হয়৷ উদাহরণস্বরূপ, গাড়ির অডিও পরিষেবা দ্বারা প্রাপ্ত একটি অডিও নিয়ন্ত্রণ HAL বাইন্ডারের মৃত্যুর বিজ্ঞপ্তি৷ যখন API কল করা হয় তখন অডিও কন্ট্রোল এইচএএল বাস্তবায়নে বিদ্যমান মডিউল পরিবর্তন কলব্যাক প্রতিস্থাপন করা উচিত।

clearModuleChangeCallback API-এর জন্য, বাস্তবায়নের জন্য বিদ্যমান কলব্যাকটি সাফ করা উচিত বা একটি বিদ্যমান না থাকলে কিছুই করবেন না। কলব্যাকের জন্য ডেথ পর্যবেক্ষক নিবন্ধন করা এবং অন বাইন্ডার ডেথ ট্রিগার হলে কলব্যাকটি সাফ করার জন্য অডিও নিয়ন্ত্রণ বাস্তবায়নের জন্য এটি একটি ভাল অনুশীলন।

IModuleChangeCallback নিম্নরূপ সংজ্ঞায়িত করা হয়েছে:

oneway interface IModuleChangeCallback {
       /**
       *   Used to indicate that one or more {@link AudioPort} configs have
       *   changed. Implementations MUST return at least one AudioPort.
       *
       *   @param audioPorts list of {@link AudioPort} that are updated
       */
       void onAudioPortsChanged(in AudioPort[] audioPorts);
}

যখন মডিউল পরিবর্তন কলব্যাকটি গাড়ী অডিও পরিষেবা দ্বারা নিবন্ধিত হয়, তখন এটি onAudioPortChanged API-এর মাধ্যমে অডিও পোর্ট পরিবর্তনগুলি গ্রহণ করতে প্রস্তুত৷ কলব্যাক নিবন্ধিত হওয়ার সাথে সাথে অডিও সিস্টেমের জন্য ভলিউম লাভ শুরু করতে API ব্যবহার করা যেতে পারে। অন্যান্য গতিশীল লাভ পরিবর্তনের জন্য, API যে কোনো সময় কল করা যেতে পারে। সংশ্লিষ্ট পরিবর্তনগুলি প্রয়োগ করা হয় এবং সেই অনুযায়ী গাড়ির অডিও পরিষেবা আপডেট করা হয়।