gpac / gpac

GPAC Ultramedia OSS for Video Streaming & Next-Gen Multimedia Transcoding, Packaging & Delivery
https://gpac.io
GNU Lesser General Public License v2.1
2.61k stars 511 forks source link

feedback on wasm.gpac.io #2827

Open rbouqueau opened 3 weeks ago

rbouqueau commented 3 weeks ago

I received this feedback (in French):

par contre, je ne comprends pas ce qui se passe avec certains exemples

Running gpac gpac -stats -i https://wasm.gpac.io/data/dash/bbb_30fps.mpd dashin:forward=file -o dump/$File$:dynext
ne donne rien
l'exemple "gpac -logs=all@info -i https://wasm.gpac.io/data/video_180.mp4 @#Video reframer:saps=1 @ -o trick_play.mp4" ne donne rien non plus 
Ah je crois avoir compris

Ce serait bien d'améliorer la doc de "File import / export"

Par exemple ajouter:
"In order to load your own files, this page uses the "imp" command"
"Once you have run gpac or MP4Box to produce a new file, you can download it by running "exp FILENAME" where "FILENAME" is the output you gave in the MP4Box or gpac command line
typo:

"to design a file not on Emscripten's file system" -> "to designate a file not on Emscripten's file system"
"Otherwise, NAME designs a file to be picked on the user's file system" -> "Otherwise, NAME designates a file to be picked on the user's file system"
"This syntax CANNOT work when editing files (MP4Box, dasher context, etc...)."
Je comprends pas ce que ça veut dire
Je comprends pas vraiment comment utiliser "imp"

ce serait bien d'avoir des exemples

je viens d'essayer "imp" tout court, ça ouvre un file picker, ce serait bien de commencer par dire ça

Ce serait bien de clarifier que les fichiers ne sont pas uploadés sur un serveur GPAC, que tout reste en local

je pense que certains utilisateurs voudraient bien tester mais ne veulent pas que leurs fichiers soient uploadés sur un serveur GPAC
cette phrase est bizarre:
"If writable stream failure, the file will be stored in memory until final write or canceled."

je comprends pas vraiment ce que ça veut dire
je viens de comprendre ce que fait l'exemple "download remote DASH content" c'est pas immédiat. Si je comprends bien ça download dans le repertoire "dump" mais l'utilisateur doit ensuite executer "exp dump/" ?

Ah non, "exp" ne marche que pour un fichier

donc en gros, l'utilisateur doit se taper tous les "exp" 1 par 1

l'utilité de l'exemple est limitée
l'exemple d'extraction n'affiche rien, c'est normal? la ligne de commande a disparu ...

par contre "exp xs0-xe02.mp4" fonctionne
c'est une super idée cette page, mais je pense qu'il faudrait la mettre entre les mains d'un utilisateur novice et observer comment il l'utilise, et corriger/améliorer

"threaded" on, ça ne change rien:
Je rajouterais une phrase en intro qui dit:
"If you want to process your own files, you must first import them into the environment (see "imp" command below). Note that the files are only imported locally into your browser memory, they are not uploaded to any server. Similarly, if your command line produces any output, the output is only present in the environment. If you want to download them, you have to export them (see  the "exp" command below)"

Je réorganiserais/corrigerais aussi: 
"Usage
This page allows running the MP4Box and GPAC applications in web browsers.

Select an example and make edits, or type in your own command. Finally press Enter key or click the Run button.

The environment does not contain any source media file. You can use remote URLs (e.g. http URLs) or, if you want to process your own files, you must first import them into the environment (see "imp" command below). Note that the files are only imported locally into your browser memory, they are not uploaded to any server. 

Similarly, if your command line produces an output, the output is only present in the environment. If you want to download them, you have to export them (see  the "exp" command below).

Remote DASH and HLS playlists can be used as input, provided that they are hosted with proper CORS configurations.

The environment also provides basic shell file system and support advanced gpac configuration (see below).

NOTE: The webassembly build is experimental. It tries to uses webcodecs whenever decoding or encoding is involved. If webcodecs can't be used, it falls back to software implementation running in wasm.
"

Other points:

  1. Add a warning stating this is experimental with the list of opened issues with label "wasm".
  2. Ask for feedback by proposing to open a github issue with label "wasm".