docs: more descriptive codes and information in Getting Started tutorial for AudioCache

[Hallcoder]

Checklist

• I made sure that the feature I am proposing doesn't already exist

Use case / Problem

Proposal / Solution

Example Code

void main() {
}

Platforms

Affected Platforms:

Audio Files/URLs/Sources (optional)

Mockups (optional)

More information (optional)

[spydon]

Can you be a bit more descriptive, what is it that you think is missing from the getting started page? And does that information exist in the example app?

[Hallcoder]

I mean , informing and emphasize that one need the audio cache when working with local audio files

…

On Mon, Sep 5, 2022 at 8:01 PM Lukas Klingsbo ***@***.***> wrote: Can you be a bit more descriptive, what is it that you think is missing from the getting started page? And does that information exist in the example app? — Reply to this email directly, view it on GitHub <#1256 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AWNVVISQFR3XPDZ5PAGLXCDV4YYPBANCNFSM572QWZXA> . You are receiving this because you authored the thread.Message ID: ***@***.***>

[spydon]

I think that it is pretty clearly explained here that you need the audio cache when working with local files?
https://github.com/bluefireteam/audioplayers/blob/main/getting_started.md#audiocache

In order to play Local Assets, you must use the AudioCache class. AudioCache is not available for Flutter Web.

Flutter does not provide an easy way to play audio on your assets, but this class helps a lot. It actually copies the asset to a temporary folder in the device, where it is then played as a Local File.

It works as a cache because it keeps track of the copied files so that you can replay them without delay.

[Gustl22]

I agree it could be a bit more clear, for which sources you need to use the AudioCache, and what it cannot do. In fact it is only relevant for AssetSource. Or better link to the migration guide, where it's documented more detailed.

[gadishimwe]

Hi @Gustl22,
Why can't the use of AudioCache from the Getting Started tutorial be removed or rephrased as it's mentioned here in the Migration guide that it's dead and normally shouldn't be used by end users?
Because in the tutorial, it sounds like we must use it for local files("In order to play Local Assets, you must use the AudioCache class") which I think is misleading. Thanks

[Gustl22]

Yes, it is misleading, this could be adapted. Even web uses the AudioCache class, but differently ...