Cấu hình âm thanh trên ô tô

Trong Android 10, car_audio_configuration.xml đã thay thế car_volumes_groups.xml và IAudioControl.getBusForContext. Các tệp chính sách âm thanh (thường có trong phân vùng nhà cung cấp) đại diện cho cấu hình phần cứng âm thanh của bo mạch. Tất cả thiết bị được tham chiếu trong car_audio_configuration.xml phải được xác định trong audio_policy_configuration.xml.

Hình 1 minh hoạ tổng quan về kiến trúc dịch vụ âm thanh trên ô tô, trong đó dịch vụ âm thanh trên ô tô đọc tệp cấu hình âm thanh trên ô tô để thiết lập âm thanh cho thiết bị.

Tổng quan về cấu trúc âm thanh trên ô tô

Hình 1. Tổng quan về kiến trúc âm thanh trên ô tô.

Đặt tệp cấu hình âm thanh trên ô tô vào vendor/etc/ hoặc system/etc/ trên thiết bị, trong đó vendor/etc/ là vị trí đầu tiên mà dịch vụ âm thanh trên ô tô tìm tệp. Dịch vụ âm thanh trên ô tô đọc car_audio_configuration.xml để xác định cấu hình âm thanh.

Vùng âm thanh trên ô tô:

  • Mỗi vùng âm thanh chứa một mã nhận dạng vùng âm thanh riêng biệt.
  • Mỗi vùng âm thanh có thể được ánh xạ đến một vùng người dùng.

  • Các thao tác âm thanh trong mỗi vùng không phụ thuộc vào nhau:

    • Quyền phát âm thanh
    • Định tuyến âm thanh
    • Giảm âm thanh

  • Nhóm âm lượng trên ô tô:

    • Tất cả thiết bị âm thanh chứa một nhóm âm lượng đều được kiểm soát cùng nhau với cùng mức tăng. Cấu hình mức tăng âm thanh cho tất cả thiết bị trong một nhóm phải giống nhau.

    • Ánh xạ ngữ cảnh âm thanh với thiết bị âm thanh. Sử dụng tính năng này để tạo bản phối âm thanh ánh xạ việc sử dụng âm thanh với thiết bị đầu ra.

    • Tất cả ngữ cảnh âm thanh phải được biểu thị trong một vùng. Điều này cho phép thiết lập chính xác định tuyến âm thanh cho tất cả cách sử dụng thuộc tính âm thanh.

Ngữ cảnh âm thanh

Để đơn giản hoá cấu hình âm thanh AAOS, các cách sử dụng tương tự đã được nhóm thành CarAudioContexts. Các ngữ cảnh âm thanh này được dùng trong CarAudioService để xác định việc định tuyến, nhóm âm lượng, quyền phát âm thanh và quản lý tính năng giảm âm thanh. Các ngữ cảnh âm thanh tĩnh trong AAOS được liệt kê trong bảng này.

Bảng này mô tả mối quan hệ ánh xạ giữa ngữ cảnh âm thanh và cách sử dụng. Các hàng được đánh dấu được cung cấp cho một cách sử dụng hệ thống mới.

CarAudioContext AttributeUsages được liên kết
MUSIC UNKNOWN
GAME
MEDIA
NAVIGATION ASSISTANCE_NAVIGATION_GUIDANCE
VOICE_COMMAND ASSISTANT
ASSISTANCE_ACCESSIBILITY
CALL_RING NOTIFICATION_RINGTONE
CALL VOICE_COMMUNICATION
VOICE_COMMUNICATION_SIGNALING
ALARM ALARM
NOTIFICATION NOTIFICATION
NOTIFICATION_*
SYSTEM_SOUND ASSISTANCE_SONIFICATION
EMERGENCY EMERGENCY
SAFETY SAFETY
VEHICLE_STATUS VEHICLE_STATUS
ANNOUNCEMENT ANNOUNCEMENT

Bật tính năng định tuyến AAOS

Để sử dụng tính năng định tuyến dựa trên AAOS, bạn phải đặt cờ audioUseDynamicRouting thành true:

<resources>
    <bool name="audioUseDynamicRouting">true</bool>
</resources>

Khi false, tính năng định tuyến và phần lớn CarAudioService sẽ bị tắt và AAOS sẽ quay lại hành vi mặc định của AudioService.

Công cụ chính sách âm thanh có thể định cấu hình

Để mở rộng hơn nữa việc quản lý âm thanh trên ô tô trong Android 14, AAOS đã giới thiệu việc sử dụng tính năng quản lý âm thanh thông qua Công cụ chính sách âm thanh có thể định cấu hình (CAP). Việc này giúp bạn linh hoạt hơn trong việc kiểm soát tính năng định tuyến âm thanh và quản lý âm lượng, đồng thời cung cấp định nghĩa linh hoạt về:

Bạn có thể bật công cụ Chính sách âm thanh có thể định cấu hình (CAP) bằng cách sử dụng useCoreAudioVolume và useCoreAudioRouting. Hãy xem bài viết Công cụ chính sách âm thanh có thể định cấu hình để biết thông tin chi tiết.

Vùng chính

Theo mặc định, tất cả âm thanh đều được định tuyến đến vùng chính. Chỉ có một vùng chính tồn tại, được biểu thị trong cấu hình bằng thuộc tính isPrimary="true". Vùng chính được tự động gán Audiomanager.PRIMARY_AUDIO_ZONE.

Cấu hình mẫu (phiên bản 2)

Ví dụ: một chiếc xe có thể có 2 vùng, một vùng chính và một hệ thống giải trí ở ghế sau. Trong trường hợp này, bạn có thể thiết kế phiên bản car_audio_configuration.xml 2 như sau:

<audioZoneConfiguration version="2.0">
       <zone name="primary zone" isPrimary="true">
           <volumeGroups>
               <group>
                   <device address="bus0_media_out">
                       <context context="music"/>
                       <context context="announcement"/>
                   </device>
                   <device address="bus3_call_ring_out">
                       <context context="call_ring"/>
                   </device>
                   <device address="bus6_notification_out">
                       <context context="notification"/>
                   </device>
               </group>
               <group>
                   <device address="bus1_navigation_out">
                       <context context="navigation"/>
                   </device>
                   <device address="bus2_voice_command_out">
                       <context context="voice_command"/>
                   </device>
               </group>
               <group>
                   <device address="bus4_call_out">
                       <context context="call"/>
                   </device>
               </group>
               <group>
                   <device address="bus5_alarm_out">
                       <context context="alarm"/>
                   </device>
               </group>
               <group>
                   <device address="bus7_system_sound_out">
                       <context context="system_sound"/>
                       <context context="emergency"/>
                       <context context="safety"/>
                       <context context="vehicle_status"/>
                   </device>
               </group>
           </volumeGroups>
       </zone>
        <zone name="rear seat zone" audioZoneId="1">
           <volumeGroups>
               <group>
                   <device address="bus100_rear_seat">
                       <context context="music"/>
                       <context context="navigation"/>
                       <context context="voice_command"/>
                       <context context="call_ring"/>
                       <context context="call"/>
                       <context context="alarm"/>
                       <context context="notification"/>
                       <context context="system_sound"/>
                       <context context="emergency"/>
                       <context context="safety"/>
                       <context context="vehicle_status"/>
                       <context context="announcement"/>
                   </device>
               </group>
           </volumeGroups>
    </zones>
</audioZoneConfiguration>

Trong ví dụ này, vùng chính tách một số ngữ cảnh âm thanh ra các thiết bị khác nhau. Điều này cho phép HAL áp dụng các hiệu ứng xử lý hậu kỳ khác nhau và kết hợp đầu ra trên mỗi thiết bị bằng cách sử dụng phần cứng của xe. Các thiết bị đã được sắp xếp thành nhiều nhóm âm lượng: nội dung nghe nhìn, chỉ đường, cuộc gọi, báo thức và âm thanh hệ thống. Nếu hệ thống được định cấu hình để useFixedVolume, thì mức âm lượng cho mỗi nhóm sẽ được chuyển đến HAL để áp dụng cho đầu ra của các thiết bị này.

Đối với vùng chính, bạn nên tách âm thanh hệ thống khỏi các âm thanh khác. Điều này cho phép xử lý âm thanh trên xe với mức độ ưu tiên cao hơn. Dịch vụ âm thanh trên ô tô đã tạo ra những điểm khác biệt này cho âm thanh trên xe về mặt quản lý quyền phát âm thanh và tính năng giảm âm thanh. Ví dụ: yêu cầu quyền phát âm thanh khẩn cấp có mức độ ưu tiên cao hơn một yêu cầu quyền phát âm thanh khác.

Trong ví dụ về vùng phụ, tất cả ngữ cảnh âm thanh đều được định tuyến đến một thiết bị và một nhóm âm lượng.

Định nghĩa nhóm âm lượng cho công cụ CAP

Để sử dụng tính năng quản lý âm lượng thông qua công cụ CAP như đã đề cập trong Công cụ chính sách âm thanh có thể định cấu hình, định nghĩa nhóm âm lượng cũng phải chứa tên:


<group name="media">
  <device address="bus0_media_out">
    <context context="music"/>
    <context context="announcement"/>
  </device>
  <device address="bus3_call_ring_out">
     <context context="call_ring"/>
  </device>
  <device address="bus6_notification_out">
    <context context="notification"/>
  </device>
</group>
<group name="navigation">
  <device address="bus1_navigation_out">
    <context context="navigation"/>
  </device>
  <device address="bus2_voice_command_out">
    <context context="voice_command"/>
  </device>
</group>

Tên nhóm âm lượng này phải khớp với tên âm lượng được xác định trong công cụ CAP. Ngoài ra, bạn cũng phải đặt useFixedVolume thành false. Hãy xem bài viết Cờ cấu hình âm thanh AAOS để biết thông tin chi tiết.

Cấu hình âm thanh vùng người dùng

Trong Android 11, car_audio_configuration.xml đã giới thiệu 2 trường mới là audioZoneId và occupantZoneId. Bạn có thể sử dụng audioZoneId để kiểm soát việc quản lý vùng âm thanh. Bạn có thể sử dụng occupantZoneId để định cấu hình tính năng định tuyến dựa trên mã nhận dạng người dùng.

Xem lại cấu hình âm thanh, nhưng sử dụng trường mới cho mã nhận dạng vùng người dùng và ánh xạ mã nhận dạng vùng âm thanh, bạn có thể thiết lập cấu hình mới mà không có định nghĩa nhóm âm lượng như sau:

<audioZoneConfiguration version="2.0">
       <zone name="primary zone" isPrimary="true" occupantZoneId="0">
         ...
       </zone>
       <zone name="rear seat zone" audioZoneId="1" occupantZoneId="1">
         ...
       </zone>
    </zones>
</audioZoneConfiguration>

Cấu hình xác định mối quan hệ ánh xạ cho vùng chính với vùng người dùng 0 và audioZoneId 1 với occupantZoneId 1. Bạn có thể định cấu hình mọi mối quan hệ ánh xạ giữa vùng người dùng và vùng âm thanh. Tuy nhiên, mối quan hệ ánh xạ phải là một-một. Các quy tắc xác định 2 trường mới là:

  • audioZoneId cho vùng chính luôn là mã nhận dạng PRIMARY_AUDIO_ZONE. Nếu isPrimary="true" được xác định, thì audioZoneIdkhông cần.

  • Bạn không thể lặp lại các số audioZoneId và occupantZoneId.

  • audioZoneId và occupantZoneId chỉ có thể có mối quan hệ ánh xạ một-một.

Cấu hình âm thanh trên ô tô trong Android 14

Trong Android 14, AAOS đã giới thiệu dịch vụ trình bổ trợ OEM, cho phép bạn quản lý hành vi âm thanh do dịch vụ âm thanh trên ô tô giám sát. Cùng với các dịch vụ trình bổ trợ mới, các thay đổi sau đây được thêm vào tệp cấu hình âm thanh trên ô tô:

  • Ngữ cảnh âm thanh trên ô tô do OEM xác định
  • Cấu hình động cho vùng không phải là vùng chính

Ngữ cảnh âm thanh trên ô tô do OEM xác định

Để bật cấu hình âm thanh linh hoạt, trong Android 14, dịch vụ âm thanh trên ô tô cho phép nhóm các cách sử dụng âm thanh khác với Ngữ cảnh âm thanh tĩnh đã xác định. Bạn có thể xác định ngữ cảnh do OEM xác định này trong tệp car_audio_configuration.xml phiên bản 3.

Thay vào đó, các ngữ cảnh âm thanh tĩnh được xác định trước sẽ được sử dụng. Định dạng chung của ngữ cảnh âm thanh trên ô tô do OEM xác định sẽ được trình bày sau.

Mỗi ngữ cảnh OEM đều yêu cầu một name cùng với danh sách cách sử dụng thuộc tính âm thanh được gán cho ngữ cảnh đó. Trong ví dụ trước, 2 ngữ cảnh được xác định:

<carAudioConfiguration version="3">
    <oemContexts>
        <oemContext name="media">
            <audioAttributes>
                <usage value="AUDIO_USAGE_MEDIA" />
    <usage value="AUDIO_USAGE_UNKNOWN"/>
            </audioAttributes>
        </oemContext>
        <oemContext name="game">
            <audioAttributes>
                <usage value="AUDIO_USAGE_GAME" />
            </audioAttributes>
        </oemContext>
...
  • Ngữ cảnh media chứa AUDIO_USAGE_MEDIA và AUDIO_USAGE_UNKNOWN
  • Ngữ cảnh game chỉ chứa AUDIO_USAGE_GAME

Bạn phải xác định ngữ cảnh ở đầu tệp car_audio_configuration.xml. Khi các ngữ cảnh OEM được xác định, phần còn lại của cấu hình âm thanh trên ô tô có thể tiếp tục như trước. Các quy tắc sau áp dụng cho ngữ cảnh âm thanh trên ô tô:

  • Định nghĩa ngữ cảnh OEM là không bắt buộc. Thay vào đó, ngữ cảnh Âm thanh tĩnh sẽ được sử dụng.

  • Không lặp lại tên ngữ cảnh.

  • Không gán cách sử dụng thuộc tính âm thanh cho nhiều ngữ cảnh.

  • Bạn nên sử dụng tất cả cách sử dụng âm thanh được xác định trong AudioAttributes để tạo ngữ cảnh.

Nói một cách chính xác, bạn phải sử dụng chuỗi android.audio.policy.configuration.V7_0.AudioUsage biểu thị cách sử dụng âm thanh cho định nghĩa ngữ cảnh âm thanh OEM. Trong tương lai, các cách sử dụng thuộc tính âm thanh mới hơn sẽ được gán cho ngữ cảnh phù hợp nhất để giảm lỗi khi di chuyển từ phiên bản Android này sang phiên bản Android khác.

Mặc dù ngữ cảnh do OEM xác định được giới thiệu để mở rộng hơn nữa dịch vụ âm thanh trình bổ trợ OEM, nhưng bạn vẫn có thể sử dụng ngữ cảnh này mà không cần dịch vụ âm thanh trình bổ trợ OEM. Hành vi âm thanh tương tự như hành vi của dịch vụ âm thanh tĩnh:

  • Tương tác quyền phát âm thanh. Thuộc tính âm thanh được dùng để xác định hành vi phù hợp nhất do ma trận tương tác quyền phát âm thanh thiết lập. Để biết thông tin chi tiết, hãy xem bài viết Quyền phát âm thanh.

  • Thuộc tính âm thanh kiểm soát âm lượng được dùng để xác định thuộc tính phù hợp nhất:

    • Nhóm âm lượng dựa trên ngữ cảnh do OEM xác định.
    • Mức độ ưu tiên từ danh sách âm lượng tĩnh đã định cấu hình.

  • Hành vi giảm âm thanh:

    • Cách sử dụng thuộc tính âm thanh cho quyền phát âm thanh hiện tại được dùng để ánh xạ với thông tin thiết bị âm thanh đầu ra như được xác định trong tệp cấu hình âm thanh trên ô tô.

    • Thuộc tính âm thanh được dùng để ánh xạ ngữ cảnh tĩnh tương ứng với tính năng giảm âm thanh, dựa trên ma trận giảm âm thanh tĩnh.

Chiến lược sản phẩm của công cụ CAP

Khi một thiết bị phải sử dụng công cụ CAP để quản lý âm lượng hoặc định tuyến, ngữ cảnh do OEM xác định phải khớp với định nghĩa chiến lược sản phẩm của công cụ CAP. Nếu không, bạn có thể sử dụng ngữ cảnh do OEM xác định mà không cần công cụ CAP.

Để tìm hiểu thêm, hãy xem chiến lược sản phẩm của công cụ CAP sản phẩm trong AAOS.

Cấu hình vùng âm thanh động

Trong Android 14, để phù hợp với cấu hình vùng âm thanh động, giản đồ cấu hình âm thanh trên ô tô để xác định vùng âm thanh cũng được cập nhật lên phiên bản 3. Giản đồ mới yêu cầu thiết lập cấu hình cho từng vùng.

<carAudioConfiguration version="3">
    <!-- optional OEM context -->
    <oemContexts>
      <oemContext name="media">
        <audioAttributes>
          <usage value="AUDIO_USAGE_MEDIA" />
          <usage value="AUDIO_USAGE_UNKNOWN"/>
        </audioAttributes>
      </oemContext>
      <oemContext name="game">
        <audioAttributes>
          <usage value="AUDIO_USAGE_GAME" />
        </audioAttributes>
      </oemContext>
...
    </oemContexts>
  <zones>
    <zone name="primary zone" isPrimary="true" occupantZoneId="0">
      <zoneConfigs>
        <zoneConfig name="primary zone config 0" isDefault="true">
          <volumeGroups>
            <group>
              <device address="bus0_media_out">
                <context context="media"/>
            <context context="game"/>
                <context context="announcement"/>
              </device>
              <device address="bus6_notification_out">
                <context context="notification"/>
              </device>
            </group>
  ...
      </zoneConfigs>
    </zone
  </zones>

Để tìm hiểu thêm, hãy xem tệp phiên bản 3 được xác định trong device/generic/car/emulator/audio/car_audio_configuration.xml. Kể từ Android 14, vùng chính chỉ có thể có một (1) cấu hình. Các vùng không phải là vùng chính có thể có nhiều cấu hình. Các quy tắc sau áp dụng cho cấu hình âm thanh trên ô tô:

  • Vùng âm thanh chính chỉ có thể có một cấu hình.

  • Các vùng âm thanh không phải là vùng chính có thể có nhiều cấu hình.

  • Tên phải là duy nhất cho từng vùng âm thanh và cấu hình vùng âm thanh.

  • Trong một vùng âm thanh, cấu hình âm thanh có thể khác nhau:

    • Không nhất thiết phải thiết lập giống nhau cho các nhóm âm lượng.
    • Không nhất thiết phải gán ngữ cảnh âm thanh giống nhau.

  • Tên thiết bị đầu ra âm thanh phải là duy nhất trên các vùng hoặc cấu hình. Tên thiết bị chỉ xuất hiện một lần trong cấu hình âm thanh hoặc vùng.

  • Các thiết bị âm thanh thuộc cùng một nhóm âm lượng phải có cùng cấu hình mức tăng âm thanh.

  • Bạn phải gán tất cả ngữ cảnh âm thanh (OEM hoặc tĩnh) cho từng cấu hình âm thanh.

Khả năng tương thích chuyển tiếp

Mặc dù các phiên bản mới của car_audio_configuration.xml giới thiệu các tính năng mới trong mỗi bản cập nhật, nhưng bạn vẫn có thể sử dụng các tệp cũ hơn trong các phiên bản AAOS mới hơn. Các OEM cập nhật lên phiên bản Android mới có thể sử dụng lại tệp car_audio_configuration.xml.

Để sử dụng một tính năng mới yêu cầu thông tin mới có trong car_audio_configuration.xml, bạn phải cập nhật phiên bản. Việc cố gắng sử dụng phiên bản cũ hơn của tệp có thông tin không được hỗ trợ trong phiên bản tệp đó sẽ gửi IllegalStateException khi dịch vụ ô tô khởi động. Thông báo ngoại lệ chứa thông tin liên quan về thông tin nào được sử dụng và phiên bản tối thiểu nào là bắt buộc.