Let me put it this way. These checks are unnecessary and are currently breaking what I'm working on, where I want to chain the tracks together and use partial drain, but I haven't got any metadata to send. Working around these checks by sending dummy metadata makes no sense. If I have to send a dummy ioctl() that does nothing to make the API work, then the API is broken. A dummy metadata does nothing, so obviously it's not needed so there was no need to mandate it.
I don't disagree that the API is being stretched beyond what we envisioned when it was quickly extended for MP3/AAC. If we are going further than what was planned and tested with those two formats let's fix it since the assumptions we made may not carry over.
And having to switch between two different ways of playing audio makes no sense either - why can't I just implement one way of playing audio and if there isn't any metadata for a particular track I don't need to send any?
Because there are cases where you need to go through the regular playback path to reinitialize things properly, see below.
Also, I disagree that putting these checks in eases integration. It only eases integration if the checks are sensible and useful, if they are not then it makes integration more difficult (as in this case where it makes the integrator have to go to extra effort to send pointless dummy ioctls.) Checks should only go in at a framework level if they are preventing a case that would break things or is logically impossible. It's not impossible to play chained tracks to a DSP without any metadata.
Chaining is only possible for elementary streams, not in the general case if you may need to reinitialize the decoder based on header information. Chaining may or may not be possible as well if the format is only detected at run-time (e.g. AAC+ with SBR implicit signaling).
There is currently no way to know if the lowest levels support chained playback for a specific format and if they support or require metadata. The next_track/metadata scheme worked fine for MP3/AAC, if we extend the use of this API i suggest we fix some misses rather than taking shortcuts.
we should provide information at the codec level on whether gapless is supported
This is a bogus comment. Again, you are thinking only about gapless. This is an api for playing audio; gapless is one thing that you might want to do but not the only thing. I agree with you that we should provide this info about the codec, but this patch isn't about what the codec supports. Even if the codec supported gapless, that doesn't mean the framework should force us to send metadata even when the firmware doesn't need it.
It is totally about what the decoder implementation supports and no I am not thinking about gapless only. There is currently nothing that tells you next_track is supported and if metadata is supported/needed. You are making assumptions for your specific implementation that may or may not be true in other cases. My suggestion is to add flags, e.g.
#define COMPRESS_SUPPORTS_NEXT_TRACK (1<<0) #define COMPRESS_SUPPORTS_METADATA (1<<1) #define COMPRESS_REQUIRES_METADATA_ON_NEXT_TRACK (1<<2)
and do the relevant tests in tinycompress. That way we have a consistent behavior and you don't have to send information that isn't needed. -Pierre