自学内容网 自学内容网

Android 14 AAOS audio

乘客音频投放到主音频区

  • 场景:
    是将乘客区的Media 属性的数据通过主屏区的设备进行播放。具体而言 在副屏user11播放的音乐是输出到主屏user10的设备上,当前只针对usage是media的情况。

  • 测试用例:
    有相关的测试用例
    packages/services/Car/tests/EmbeddedKitchenSinkApp/src/com/google/android/car/kitchensink/audio/AudioUserAssignmentFragment.java

  • 测试流程:
    首先主屏中选择ask user 11 To Accept,选择确认后。 在user 11 中播放音乐, 这个是时候这个音乐是从10种输出。

  • 修改
    默认支持这种的使用方式。 但是建议media的context 独立使用一个bus address。否则跟media context处于同一个bus address的context都会被路由到主音频区的Media设备中。

  • 基本原理:
    依赖于audioPolicy的setUserIDDeviceAffinity来实现的。这个接口是更新 之前注册audioPolicyMix的情况。是判断注册的policy中
    mAudioPolicy.setUserIdDeviceAffinity(userId, devices);

动态路由配置

  • 场景:
    在同一个区域中 同一个context可以有两个可以播放的device。可以在播放过程中进行切换。
  • 测试用例packages/services/Car/tests/EmbeddedKitchenSinkApp/src/com/google/android/car/kitchensink/audio/AudioTestFragment.java
    中的switchToZoneConfigSelected。
    只有在副屏中才有这样的测试,能够进行zoneConfig的切换。
    在选项中选择了另外一个配置之后,进行音乐播放。这个是对应播放数据的地址变成新的配置。
Button zoneConfigSwitchButton =        view.findViewById(R.id.switch_zone_configuration_key_event_button);
        zoneConfigSwitchButton.setOnClickListener(
                (v) -> switchToZoneConfigSelected());
  • 需要添加的配置:
    car_audio_configuration: 添加两个zoneconfig。这两个zoneConfig的地址不一样, 只能添加到非primary zone的区域。
    比如地址为bus101_audio_zone_1 和bus100_audio_zone_1
    audio_policy_configuration: 添加同样的device,mixport等等。

  • 实现的原理:
    有提供给外部切换的接口。当调用该接口的时候,传递的是要切换的zoneconfig。
    这个zoneconfig 中包含的是要切换的zone的信息 包括address 等等。
    切换就是建立起userid 和 address的关系, 通过audiopolicy的setUserIdDeviceAffinity来实现。
    这个时候在audiopolicyManager 中存储的是userid 和 新的address 的mix。
    播放的时候会获取关系就获取的是新的address。

### AudioControl hal需要实现的功能

  1. registerFocusListener: carAudioService 注册回调到control AudioControl hal 向CarAudioService 请求焦点。
  2. onAudioFocusChange:CarAudioServie通知control 服务层焦点的变化,在control中请求焦点也会在这里告知。
  3. requestAudioFocus: hal层向CarAudioService 请求焦点
  4. abandonAudioFocus:hal层放弃某个焦点的请求。

上述 API 可分别用于从 HAL 请求和放弃音频焦点。作为响应,车载音频服务会考虑音频焦点请求,并将结果异步转发给 IAudioControl#onAudioFocusChange 方法。

  • 增益变化的通知

将hal层(可能外部接入设备的音量变化的信息)音量信息通知给服务层,服务层获取这个信息 进行ui的改变等等操作。
这个事实上是提供了一个外部的设备(比如dsp 放大器)等等音频设备和android CarAudioService交互的路径。

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);
}
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);
}
  • carVolumeGroupInfo

CarVolumeGroup 更改的事件类型

CarVolumeGroupEvent。每个事件都包含三种关键类型的信息:
CarVolumeGroupInfo列表
EventTypes (位图)
ExtraInfos列表

controlhal实现的具体流程

carAudioService init的时候会注册上层服务的回调到audioControlHal中。

public void init() {
setupHalAudioFocusListenerLocked();
setupHalAudioGainCallbackLocked();
setupHalAudioModuleChangeCallbackLocked();
}

  • 首先是AudioFocus的注册

实现在HalAudioFocus中,是将HalAudioFocus的实现注册到AudioControl当中。在默认的AudioControl.cpp的
实现中。通过这个Listener 向CarAudioSerice请求焦点。

    public void registerFocusListener() {
        mAudioControlWrapper.registerFocusListener(this);
    }

ndk::ScopedAStatus AudioControl::registerFocusListener(
        const shared_ptr<IFocusListener>& in_listener) {
    if (in_listener) {
        std::atomic_store(&mFocusListener, in_listener);
    } else {
        LOG(ERROR) << "Unexpected nullptr for listener resulting in no-op.";
    }

}

binder_status_t AudioControl::cmdRequestFocus(int fd, const char** args, uint32_t numArgs) {
    AudioFocusChange focusGain = AudioFocusChange(focusGainValue);
    if (mFocusListener == nullptr) {
        dprintf(fd, "Unable to request focus - no focus listener registered\n");
        return STATUS_BAD_VALUE;
    }
    mFocusListener->requestAudioFocus(usage, zoneId, focusGain);
    dprintf(fd, "Requested focus for usage %s, zoneId %d, and focusGain %d\n", usage.c_str(),
            zoneId, focusGain);
    return STATUS_OK;
}

回调到carAudioService中 makeAudioFocusRequestLocked进行焦点的请求。
其调用audioManager的requestAudioFocus请求焦点(这个实际也是回调到CarAudioService进行处理)
同时调用onAuioFocusChange通知到audioControl中。

    public void requestAudioFocus(@AttributeUsage int usage, int zoneId, int focusGain) {
        synchronized (mLock) {
            AudioAttributesWrapper audioAttributesWrapper =
                    CarAudioContext.getAudioAttributeWrapperFromUsage(usage);
            HalAudioFocusRequest currentRequest =
                    mHalFocusRequestsByZoneAndUsage.get(zoneId).get(audioAttributesWrapper);
            if (currentRequest != null) {
                if (Slogf.isLoggable(TAG, Log.DEBUG)) {
                    Slogf.d(TAG, "A request already exists for zoneId " + zoneId + " and usage "
                            + usage);
                }
                mAudioControlWrapper.onAudioFocusChange(usage, zoneId, currentRequest.mFocusStatus);
            } else {
                makeAudioFocusRequestLocked(audioAttributesWrapper, zoneId, focusGain);
            }
        }
    }

    private void makeAudioFocusRequestLocked(
            AudioAttributesWrapper audioAttributesWrapper,
            int zoneId, int focusGain) {
        AudioFocusRequest audioFocusRequest =
                generateFocusRequestLocked(audioAttributesWrapper, zoneId, focusGain);
        int requestResult = mAudioManager.requestAudioFocus(audioFocusRequest);
        int resultingFocusGain = focusGain;
        if (requestResult == AUDIOFOCUS_REQUEST_GRANTED) {
            HalAudioFocusRequest halAudioFocusRequest =
                    new HalAudioFocusRequest(audioFocusRequest, focusGain);
            mHalFocusRequestsByZoneAndUsage.get(zoneId)
                    .put(audioAttributesWrapper, halAudioFocusRequest);
        } else if (requestResult == AUDIOFOCUS_REQUEST_FAILED) {
            resultingFocusGain = AUDIOFOCUS_LOSS;
        } else if (requestResult == AUDIOFOCUS_REQUEST_DELAYED) {
            Slogf.w(TAG, "Delayed result for request with audio attributes "
                    + audioAttributesWrapper + ", zoneId " + zoneId
                    + ", and focusGain " + focusGain);
            resultingFocusGain = AUDIOFOCUS_LOSS;
        }
        mAudioControlWrapper.onAudioFocusChange(
                audioAttributesWrapper.getAudioAttributes().getSystemUsage(),
                zoneId, resultingFocusGain);
    }



总结: CarAudioService 和 control hal之间的交互,CarAudioService注册
HalFocusListener到control。 control 通过listener提供的requestAudioFocus传递usage、zoneID和focus请求的类型
请求焦点,carAudioService响应焦点请求 之后通过onAudioFocusChange通知control hal焦点请求的情况。

control hal AudioGain的callback

有关的实现在CarAudioGainMonitor中, 跟audioFocus的流程是一样的,都是先注册callback到control。 然后control利用这个callback 将
增益变化的信息传递出来。传递的信息包括两个部分:

  1. Reason 增益变化的原因
  2. AudioGainConfigInfo 包含zoneID、device address、index。
    其中reason的定义见如下。

消息回调到CarAudioGainMonitor中 首先调用如下的函数将hal的reason转换为CarVolumeGroupEvent。
carAudioZone.onAudioGainChanged(reasons, gainsByZones.valueAt(i))
最后是调用的CarVolumeGroup的onAudioGainChanged来实现的。
这个过程会根据当前系统的状态结合gain index信息来 转换最后的EVENT_TYPE。

转换后的event通过下面的回调 回调到carAudioService的onVolumeGroupEvent中、
mCarVolumeInfoWrapper.onVolumeGroupEvent(events);
这里面会回调onGroupVolumeChanged给所有调用registerCarVolumeCallback注册callback的应用
比如VolumeSettingsPreferenceController,收到回调后会调整音量和mute的状态。

    private void setupHalAudioGainCallbackLocked() {
        AudioControlWrapper audioControlWrapper = getAudioControlWrapperLocked();
        if (!audioControlWrapper.supportsFeature(AUDIOCONTROL_FEATURE_AUDIO_GAIN_CALLBACK)) {
            Slogf.e(CarLog.TAG_AUDIO, "HalAudioGainCallback is not supported on this device");
            return;
        }
        mCarAudioGainMonitor = new CarAudioGainMonitor(mAudioControlWrapper,
                new CarVolumeInfoWrapper(this), mCarAudioZones);
        mCarAudioGainMonitor.registerAudioGainListener(mHalAudioGainCallback);
    }


    public void registerAudioGainListener(HalAudioGainCallback callback) {
        Objects.requireNonNull(callback, "Hal Audio Gain callback can not be null");
        mAudioControlWrapper.registerAudioGainCallback(callback);
    }

ndk::ScopedAStatus AudioControl::registerGainCallback(
        const std::shared_ptr<IAudioGainCallback>& in_callback) {
    LOG(DEBUG) << ": " << __func__;
    if (in_callback) {
        std::atomic_store(&mAudioGainCallback, in_callback);
    } else {
        LOG(ERROR) << "Unexpected nullptr for audio gain callback resulting in no-op.";
    }
    return ndk::ScopedAStatus::ok();
}

binder_status_t AudioControl::cmdOnAudioDeviceGainsChanged(int fd, const char** args,
                                                           uint32_t numArgs) 
    std::vector<AudioGainConfigInfo> agcis{};
    for (uint32_t i = 3; i < numArgs; i += 2) {
        std::string deviceAddress = std::string(args[i]);
        int32_t index;
        if (!safelyParseInt(std::string(args[i + 1]), &index)) {
            dprintf(fd, "Non-integer index provided with request: %s\n",
                    std::string(args[i + 1]).c_str());
            return STATUS_BAD_VALUE;
        }
        AudioGainConfigInfo agci{zoneId, deviceAddress, index};
        agcis.push_back(agci);
    }

    mAudioGainCallback->onAudioDeviceGainsChanged(reasons, agcis);
    dprintf(fd, "Fired audio gain callback for reasons=%s and gains=%s\n",
            toEnumString(reasons).c_str(), toString(agcis).c_str());
    return STATUS_OK;
}


public @interface Reasons {
public static final int FORCED_MASTER_MUTE = 1;
public static final int REMOTE_MUTE = 2;
public static final int TCU_MUTE = 4;
public static final int ADAS_DUCKING = 8;
public static final int NAV_DUCKING = 16;
public static final int PROJECTION_DUCKING = 32;
public static final int THERMAL_LIMITATION = 64;
public static final int SUSPEND_EXIT_VOL_LIMITATION = 128;
public static final int EXTERNAL_AMP_VOL_FEEDBACK = 256;
public static final int OTHER = -2147483648;
}

parcelable AudioGainConfigInfo {
    /**
     * The identifier for the audio zone the audio device port associated to this gain belongs to.
     *
     */
    int zoneId;

    /**
     * The Audio Output Device Port Address.
     *
     * This is the address that can be retrieved at JAVA layer using the introspection
     * {@link android.media.AudioManager#listAudioDevicePorts} API then
     * {@link audio.media.AudioDeviceInfo#getAddress} API.
     *
     * At HAL layer, it corresponds to audio_port_v7.audio_port_device_ext.address.
     *
     * Devices that does not have an address will indicate an empty string "".
     */
    String devicePortAddress;

    /**
     * UI Index of the corresponding AudioGain in AudioPort.gains.
     */
    int volumeIndex;
}

总结:CarAudioService通过注册HalAudioGainCallback到control、然后control 在有Gain变化的时候。通过调调用listener的onAudioDeviceGainsChanged
将Gain变化的信息传递出来。CarAudioService将event转换为group的event。在传递给应用等等。

AudioModuleChange变化的通知

处理在CarAudioModuleChangeMonitor,通过将HalAudioModuleChangeCallback注册到control中。之后在control中创建一个或多个AudioPort。将这个Port通过callback的onAudioPortsChanged回调回carAudioService。最后通过
CarVolume的onVolumeGroupEvent通知到各个应用。

    void setModuleChangeCallback(HalAudioModuleChangeCallback callback) {
        Objects.requireNonNull(callback, "Hal audio module change callback can not be null");
        mAudioControlWrapper.setModuleChangeCallback(callback);
    }

ndk::ScopedAStatus AudioControl::setModuleChangeCallback(
        const std::shared_ptr<IModuleChangeCallback>& in_callback) {
    std::atomic_store(&mModuleChangeCallback, in_callback);
    return ndk::ScopedAStatus::ok();
}

binder_status_t AudioControl::cmdOnAudioPortsChanged(int fd, const char** args, uint32_t numArgs) {
    if (!checkCallerHasWritePermissions(fd)) {
        return STATUS_PERMISSION_DENIED;
    } 
   mModuleChangeCallback->onAudioPortsChanged(ports);
}


原文地址:https://blog.csdn.net/H2008066215019910120/article/details/136355301

免责声明:本站文章内容转载自网络资源,如本站内容侵犯了原著者的合法权益,可联系本站删除。更多内容请关注自学内容网(zxcms.com)!