audio: Add Dual Mono Mode and Audio Description Mix Level to IStreamOut (0a675fcc) · Commits · e / os / android_hardware_interfaces

audio/6.0/IStreamOut.hal

+57 −0

Original line number	Diff line number	Diff line
		@@ -276,4 +276,61 @@ interface IStreamOut extends IStream {
		*/
		selectPresentation(int32_t presentationId, int32_t programId)
		generates (Result retval);

		/**
		* Returns the Dual Mono mode presentation setting.
		*
		* Optional method
		*
		* @return retval operation completion status.
		* @return mode current setting of Dual Mono mode.
		*/
		getDualMonoMode() generates (Result retval, DualMonoMode mode);

		/**
		* Sets the Dual Mono mode presentation on the output device.
		*
		* The Dual Mono mode is generally applied to stereo audio streams
		* where the left and right channels come from separate sources.
		*
		* Optional method
		*
		* @param mode selected Dual Mono mode.
		* @return retval operation completion status.
		*/
		setDualMonoMode(DualMonoMode mode) generates (Result retval);

		/**
		* Returns the Audio Description Mix level in dB.
		*
		* The level is applied to streams incorporating a secondary Audio
		* Description stream. It specifies the relative level of mixing for
		* the Audio Description with a reference to the Main Audio.
		*
		* Optional method
		*
		* The value of the relative level is in the range from negative infinity
		* to +48.
		*
		* @return retval operation completion status.
		* @return leveldB the current Audio Description Mix Level in dB.
		*/
		getAudioDescriptionMixLevel() generates (Result retval, float leveldB);

		/**
		* Sets the Audio Description Mix level in dB.
		*
		* For streams incorporating a secondary Audio Description stream
		* the relative level of mixing of the Audio Description to the Main Audio
		* is controlled by this method.
		*
		* Optional method
		*
		* The value of the relative level must be in the range from negative
		* infinity to +48.
		*
		* @param leveldB Audio Description Mix Level in dB
		* @return retval operation completion status.
		*/
		setAudioDescriptionMixLevel(float leveldB) generates (Result retval);
		};

audio/6.0/types.hal

+50 −0

Original line number	Diff line number	Diff line
		@@ -247,3 +247,53 @@ enum MicrophoneDirection : int32_t {
		*/
		EXTERNAL = 3,
		};


		/* Dual Mono handling is used when a stereo audio stream
		* contains separate audio content on the left and right channels.
		* Such information about the content of the stream may be found, for example,
		* in ITU T-REC-J.94-201610 A.6.2.3 Component descriptor.
		*/
		@export(name="audio_dual_mono_mode_t", value_prefix="AUDIO_DUAL_MONO_MODE_")
		enum DualMonoMode : int32_t {
		// Need to be in sync with DUAL_MONO_MODE* constants in
		// frameworks/base/media/java/android/media/AudioTrack.java
		/**
		* Disable any Dual Mono presentation effect.
		*
		*/
		OFF = 0,
		/**
		* This mode indicates that a stereo stream should be presented
		* with the left and right audio channels blended together
		* and delivered to both channels.
		*
		* Behavior for non-stereo streams is implementation defined.
		* A suggested guideline is that the left-right stereo symmetric
		* channels are pairwise blended, the other channels such as center
		* are left alone.
		*/
		LR = 1,
		/**
		* This mode indicates that a stereo stream should be presented
		* with the left audio channel replicated into the right audio channel.
		*
		* Behavior for non-stereo streams is implementation defined.
		* A suggested guideline is that all channels with left-right
		* stereo symmetry will have the left channel position replicated
		* into the right channel position. The center channels (with no
		* left/right symmetry) or unbalanced channels are left alone.
		*/
		LL = 2,
		/**
		* This mode indicates that a stereo stream should be presented
		* with the right audio channel replicated into the left audio channel.
		*
		* Behavior for non-stereo streams is implementation defined.
		* A suggested guideline is that all channels with left-right
		* stereo symmetry will have the right channel position replicated
		* into the left channel position. The center channels (with no
		* left/right symmetry) or unbalanced channels are left alone.
		*/
		RR = 3,
		};

audio/core/all-versions/default/StreamOut.cpp

+20 −0

Original line number	Diff line number	Diff line
		@@ -582,6 +582,26 @@ Return<Result> StreamOut::selectPresentation(int32_t /presentationId/, int32_t
		}
		#endif

		#if MAJOR_VERSION >= 6
		Return<void> StreamOut::getDualMonoMode(getDualMonoMode_cb _hidl_cb) {
		_hidl_cb(Result::NOT_SUPPORTED, DualMonoMode::OFF);
		return Void();
		}

		Return<Result> StreamOut::setDualMonoMode(DualMonoMode /mode/) {
		return Result::NOT_SUPPORTED;
		}

		Return<void> StreamOut::getAudioDescriptionMixLevel(getAudioDescriptionMixLevel_cb _hidl_cb) {
		_hidl_cb(Result::NOT_SUPPORTED, -std::numeric_limits<float>::infinity());
		return Void();
		}

		Return<Result> StreamOut::setAudioDescriptionMixLevel(float /leveldB/) {
		return Result::NOT_SUPPORTED;
		}
		#endif

		} // namespace implementation
		} // namespace CPP_VERSION
		} // namespace audio

audio/core/all-versions/default/include/core/default/StreamOut.h

+6 −0

Original line number	Diff line number	Diff line
		@@ -121,6 +121,12 @@ struct StreamOut : public IStreamOut {
		Return<void> updateSourceMetadata(const SourceMetadata& sourceMetadata) override;
		Return<Result> selectPresentation(int32_t presentationId, int32_t programId) override;
		#endif
		#if MAJOR_VERSION >= 6
		Return<void> getDualMonoMode(getDualMonoMode_cb _hidl_cb) override;
		Return<Result> setDualMonoMode(DualMonoMode mode) override;
		Return<void> getAudioDescriptionMixLevel(getAudioDescriptionMixLevel_cb _hidl_cb) override;
		Return<Result> setAudioDescriptionMixLevel(float leveldB) override;
		#endif

		static Result getPresentationPositionImpl(audio_stream_out_t* stream, uint64_t* frames,
		TimeSpec* timeStamp);

audio/core/all-versions/vts/functional/6.0/AudioPrimaryHidlHalTest.cpp

+27 −0

Original line number	Diff line number	Diff line
		@@ -190,3 +190,30 @@ TEST_P(AudioPatchHidlTest, UpdatePatchInvalidHandle) {
		hidl_vec<AudioPortConfig>(), hidl_vec<AudioPortConfig>(), returnIn(res, ignored)));
		ASSERT_RESULT(Result::INVALID_ARGUMENTS, res);
		}

		using DualMonoModeAccessorHidlTest = AccessorHidlTest<DualMonoMode, OutputStreamTest>;
		TEST_P(DualMonoModeAccessorHidlTest, DualMonoModeTest) {
		doc::test("Check that dual mono mode can be set and retrieved");
		testAccessors<OPTIONAL>(&OutputStreamTest::getStream, "dual mono mode",
		Initial{DualMonoMode::OFF},
		{DualMonoMode::LR, DualMonoMode::LL, DualMonoMode::RR},
		&IStreamOut::setDualMonoMode, &IStreamOut::getDualMonoMode);
		}

		INSTANTIATE_TEST_CASE_P(DualMonoModeHidl, DualMonoModeAccessorHidlTest,
		::testing::ValuesIn(getOutputDeviceConfigParameters()),
		&DeviceConfigParameterToString);

		using AudioDescriptionMixLevelHidlTest = AccessorHidlTest<float, OutputStreamTest>;
		TEST_P(AudioDescriptionMixLevelHidlTest, AudioDescriptionMixLevelTest) {
		doc::test("Check that audio description mix level can be set and retrieved");
		testAccessors<OPTIONAL>(
		&OutputStreamTest::getStream, "audio description mix level",
		Initial{-std::numeric_limits<float>::infinity()}, {-48.0f, -1.0f, 0.0f, 1.0f, 48.0f},
		&IStreamOut::setAudioDescriptionMixLevel, &IStreamOut::getAudioDescriptionMixLevel,
		{48.5f, 1000.0f, std::numeric_limits<float>::infinity()});
		}

		INSTANTIATE_TEST_CASE_P(AudioDescriptionMixLevelHidl, AudioDescriptionMixLevelHidlTest,
		::testing::ValuesIn(getOutputDeviceConfigParameters()),
		&DeviceConfigParameterToString);