CarAudioManager方法简介

前言

参考别人文章，看Android中车载部分CarAudioManager类中部分方法的介绍。

正文

简单记录一下CarAudioManager中方法的说明。

packages\services\Car\car-lib\src\android\car\media\CarAudioManager.java

isDynamicRoutingEnabled()

返回是否动态路由是否可用的。

public boolean isDynamicRoutingEnabled() {
    return isAudioFeatureEnabled(AUDIO_FEATURE_DYNAMIC_ROUTING);
}

isDynamicRoutingEnabled高版本废弃了，替代的是

isAudioFeatureEnabled(AUDIO_FEATURE_DYNAMIC_ROUTING);

isAudioFeatureEnabled()

public boolean isAudioFeatureEnabled(@CarAudioFeature int audioFeature) {
    try {
        return mService.isAudioFeatureEnabled(audioFeature);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, false);
    }
}

setGroupVolume()

此方法有两个，一个是指定zoneId为PRIMARY_AUDIO_ZONE，一个是让用户指定zoneId，然后设置组音量的音量

public void setGroupVolume(int groupId, int index, int flags) {
    setGroupVolume(PRIMARY_AUDIO_ZONE, groupId, index, flags);
}
​
public void setGroupVolume(int zoneId, int groupId, int index, int flags) {
    try {
        mService.setGroupVolume(zoneId, groupId, index, flags);
    } catch (RemoteException e) {
        handleRemoteExceptionFromCarService(e);
    }
}

getGroupMaxVolume()

获取组最大音量值（跟上面类似，两个方法）

public int getGroupMaxVolume(int groupId) {
    return getGroupMaxVolume(PRIMARY_AUDIO_ZONE, groupId);
}
​
public int getGroupMaxVolume(int zoneId, int groupId) {
    try {
        return mService.getGroupMaxVolume(zoneId, groupId);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, 0);
    }
}

getGroupMinVolume()

获取组最小音量值（跟上面类似，两个方法）

public int getGroupMinVolume(int groupId) {
    return getGroupMinVolume(PRIMARY_AUDIO_ZONE, groupId);
}
​
public int getGroupMinVolume(int zoneId, int groupId) {
    try {
        return mService.getGroupMinVolume(zoneId, groupId);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, 0);
    }
}

getGroupVolume()

获取groupId音量值（跟上面类似，两个方法）

public int getGroupVolume(int groupId) {
    return getGroupVolume(PRIMARY_AUDIO_ZONE, groupId);
}
​
public int getGroupVolume(int zoneId, int groupId) {
    try {
        return mService.getGroupVolume(zoneId, groupId);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, 0);
    }
}

setFadeTowardFront()

设置前后音量偏移，0.0是平衡，1.0是前面。

public void setFadeTowardFront(float value) {
    try {
        mService.setFadeTowardFront(value);
    } catch (RemoteException e) {
        handleRemoteExceptionFromCarService(e);
    }
}

setBalanceTowardRight()

设置左右音量偏移，0.0是平衡，1.0是右面。

public void setBalanceTowardRight(float value) {
    try {
        mService.setBalanceTowardRight(value);
    } catch (RemoteException e) {
        handleRemoteExceptionFromCarService(e);
    }
}

getExternalSources()

获取外部音源，除麦克风外的输入设备（警报音、DVD、收音机等）

public @NonNull String[] getExternalSources() {
    try {
        return mService.getExternalSources();
    } catch (RemoteException e) {
        handleRemoteExceptionFromCarService(e);
        return new String[0];
    }
}

createAudioPatch()

通过getExternalSources给出的input port，创建一个外部音源到output的补丁，返回一个CarAudioPatchHandle。

public CarAudioPatchHandle createAudioPatch(String sourceAddress, @AttributeUsage int usage,
        int gainInMillibels) {
    try {
        return mService.createAudioPatch(sourceAddress, usage, gainInMillibels);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, null);
    }
}

这个不是很懂。。。

releaseAudioPatch()

跟createAudioPatch()配套使用。释放input port和output的关联。

public void releaseAudioPatch(CarAudioPatchHandle patch) {
    try {
        mService.releaseAudioPatch(patch);
    } catch (RemoteException e) {
        handleRemoteExceptionFromCarService(e);
    }
}

getVolumeGroupCount()

有两个方法，一个是指定PRIMARY_AUDIO_ZONE的域，另外一个是用户传入域（zoneId）进行或可用音量组数目。

public int getVolumeGroupCount() {
    return getVolumeGroupCount(PRIMARY_AUDIO_ZONE);
}
​
public int getVolumeGroupCount(int zoneId) {
    try {
        return mService.getVolumeGroupCount(zoneId);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, 0);
    }
}

getVolumeGroupIdForUsage()

获取zoneId为PRIMARY_AUDIO_ZONE时，传入usage（音频用例）获取对应的音量组Id

public int getVolumeGroupIdForUsage(@AttributeUsage int usage) {
    return getVolumeGroupIdForUsage(PRIMARY_AUDIO_ZONE, usage);
}

根据zoneId和usage（音频用例）获取对应的音量组Id

public int getVolumeGroupIdForUsage(int zoneId, @AttributeUsage int usage) {
    try {
        return mService.getVolumeGroupIdForUsage(zoneId, usage);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, 0);
    }
}

getAudioZoneIds()

获取所有音频域的id。

public @NonNull List<Integer> getAudioZoneIds() {
    try {
        int[] zoneIdArray = mService.getAudioZoneIds();
        List<Integer> zoneIdList = new ArrayList<Integer>(zoneIdArray.length);
        for (int zoneIdValue : zoneIdArray) {
            zoneIdList.add(zoneIdValue);
        }
        return zoneIdList;
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, Collections.emptyList());
    }
}

registerCarVolumeCallback()

注册音量callback,添加到CarAudioManager维护的Callback组里，有onGroupVolumeChanged和onMasterMuteChanged的回调

public void registerCarVolumeCallback(@NonNull CarVolumeCallback callback) {
    Objects.requireNonNull(callback);
    if (mCarVolumeCallbacks.isEmpty()) {
        registerVolumeCallback();
    }
    mCarVolumeCallbacks.add(callback);
}

unregisterCarVolumeCallback()

取消注册

public void unregisterCarVolumeCallback(@NonNull CarVolumeCallback callback) {
    Objects.requireNonNull(callback);
    if (mCarVolumeCallbacks.remove(callback) && mCarVolumeCallbacks.isEmpty()) {
        unregisterVolumeCallback();
    }
}

getUsagesForVolumeGroupId()

两个方法，一个是指定zoneId为PRIMARY_AUDIO_ZONE，也就是通用域；另外一个是不指定，通过用户传入。

通过zoneId域，并指定groupId获取所有的音频用例。

public @NonNull int[] getUsagesForVolumeGroupId(int groupId) {
    return getUsagesForVolumeGroupId(PRIMARY_AUDIO_ZONE, groupId);
}
​
public @NonNull int[] getUsagesForVolumeGroupId(int zoneId, int groupId) {
    try {
        return mService.getUsagesForVolumeGroupId(zoneId, groupId);
    } catch (RemoteException e) {
        return handleRemoteExceptionFromCarService(e, new int[0]);
    }
}

参考文章

1. 《Android Q CarAudio 汽车音频学习笔记》