Merge "AIDL effect: Add queryProcess in IFactory" (a682b181) · Commits · e / os / android_hardware_interfaces

audio/aidl/Android.bp

+1 −0

Original line number	Diff line number	Diff line
		@@ -156,6 +156,7 @@ aidl_interface {
		"android/hardware/audio/effect/IEffect.aidl",
		"android/hardware/audio/effect/IFactory.aidl",
		"android/hardware/audio/effect/Parameter.aidl",
		"android/hardware/audio/effect/Processing.aidl",
		"android/hardware/audio/effect/State.aidl",
		],
		imports: [

audio/aidl/aidl_api/android.hardware.audio.effect/current/android/hardware/audio/effect/Descriptor.aidl

+2 −1

Original line number	Diff line number	Diff line
		@@ -53,10 +53,11 @@ parcelable Descriptor {
		parcelable Identity {
		android.media.audio.common.AudioUuid type;
		android.media.audio.common.AudioUuid uuid;
		@nullable android.media.audio.common.AudioUuid proxy;
		android.hardware.audio.effect.Flags flags;
		}
		@VintfStability
		parcelable Common {
		android.hardware.audio.effect.Descriptor.Identity id;
		android.hardware.audio.effect.Flags flags;
		}
		}

audio/aidl/aidl_api/android.hardware.audio.effect/current/android/hardware/audio/effect/IFactory.aidl

+1 −0

Original line number	Diff line number	Diff line
		@@ -35,6 +35,7 @@ package android.hardware.audio.effect;
		@VintfStability
		interface IFactory {
		android.hardware.audio.effect.Descriptor.Identity[] queryEffects(in @nullable android.media.audio.common.AudioUuid type, in @nullable android.media.audio.common.AudioUuid implementation);
		android.hardware.audio.effect.Processing[] queryProcessing(in @nullable android.hardware.audio.effect.Processing.Type type);
		android.hardware.audio.effect.IEffect createEffect(in android.media.audio.common.AudioUuid implUuid);
		void destroyEffect(in android.hardware.audio.effect.IEffect handle);
		}

audio/aidl/aidl_api/android.hardware.audio.effect/current/android/hardware/audio/effect/Processing.aidl

0 → 100644

+44 −0

Original line number	Diff line number	Diff line
		/*
		* Copyright (C) 2022 The Android Open Source Project
		*
		* Licensed under the Apache License, Version 2.0 (the "License");
		* you may not use this file except in compliance with the License.
		* You may obtain a copy of the License at
		*
		* http://www.apache.org/licenses/LICENSE-2.0
		*
		* Unless required by applicable law or agreed to in writing, software
		* distributed under the License is distributed on an "AS IS" BASIS,
		* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
		* See the License for the specific language governing permissions and
		* limitations under the License.
		*/
		///////////////////////////////////////////////////////////////////////////////
		// THIS FILE IS IMMUTABLE. DO NOT EDIT IN ANY CASE. //
		///////////////////////////////////////////////////////////////////////////////

		// This file is a snapshot of an AIDL file. Do not edit it manually. There are
		// two cases:
		// 1). this is a frozen version file - do not edit this in any case.
		// 2). this is a 'current' file. If you make a backwards compatible change to
		// the interface (from the latest frozen version), the build system will
		// prompt you to update this file with `m <name>-update-api`.
		//
		// You must not make a backward incompatible change to any AIDL file built
		// with the aidl_interface module type with versions property set. The module
		// type is used to build AIDL files in a way that they can be used across
		// independently updatable components of the system. If a device is shipped
		// with such a backward incompatible change, it has a high risk of breaking
		// later when a module using the interface is updated, e.g., Mainline modules.

		package android.hardware.audio.effect;
		@VintfStability
		parcelable Processing {
		android.hardware.audio.effect.Processing.Type type;
		android.hardware.audio.effect.Descriptor.Identity[] ids;
		@VintfStability
		union Type {
		android.media.audio.common.AudioStreamType streamType = android.media.audio.common.AudioStreamType.INVALID;
		android.media.audio.common.AudioSource source;
		}
		}

audio/aidl/android/hardware/audio/effect/Descriptor.aidl

+16 −4

Original line number	Diff line number	Diff line
		@@ -23,6 +23,13 @@ import android.media.audio.common.AudioUuid;
		/**
		* Descriptor contains all information (capabilities, attributes, etc) for an effect implementation.
		* The client uses this information to decide when and how to apply an effect implementation.
		*
		* Each type of effect can have more than one implementation (differentiated by implementation
		* UUID), the effect proxy act as a combination of two implementations (usually one software and
		* one offload implementation), so effect processing can be seamlessly switched between
		* implementations in same proxy depending on the configuration and/or use case. If the optional
		* proxy UUID is specified in Descriptor.Identity, then client must consider the effect instance as
		* part of the effect proxy.
		*/
		@VintfStability
		parcelable Descriptor {
		@@ -69,6 +76,15 @@ parcelable Descriptor {
		* UUID for this particular implementation.
		*/
		AudioUuid uuid;
		/**
		* Optional proxy UUID. This field must be set to the proxy effect type UUID if the effect
		* implementation is part of a proxy effect.
		*/
		@nullable AudioUuid proxy;
		/**
		* Capability flags defined for the effect implementation.
		*/
		Flags flags;
		}

		// Common attributes of all effect implementation.
		@@ -78,10 +94,6 @@ parcelable Descriptor {
		* Identity of effect implementation.
		*/
		Identity id;
		/**
		* Effect engine defined capabilities/requirements flags.
		*/
		Flags flags;
		}
		Common common;