...
| Excerpt |
|---|
STEP 1: Adding a multimedia reference
3. If you click on any of these buttons, you will see a file-path automatically generated. Here you can see what the Media section looks like with an image file-path added:
4. At this point you have the option of uploading an image direction into the form builder. Alternatively, you can just leave this reference and add the media through the Multimedia Manager. Note that if you add a reference but do not add a media file, your application will show the file-path instead of any image, so it is important to upload files for each reference you create. Don't worry, this is why the Multimedia Manager is there. 5. You can remove the reference by clicking on the red X. 6. You can also manually change the file-path by clicking on the Advanced: Show Path button. 7. Save the Form when you've finished your changes.
Note: You can also add multimedia (image, audio) in the module menu and the form menu using the same instructions found above for adding multimedia to a form. |
...
You can find the Multimedia Manager for your application within the Settings section. The settings icon is to the right of the Project name and the Multimedia section is the second tab. After clicking on "Multimedia" you will see the following:
You will use "Download ZIP" later to grab all of your files at once. Below that there might be a note about how many references are missing files. Click on the blue "Multimedia Reference Checker" button to upload files for all the references.
A new window will open that will look like this:
Again, you can see if you have missing files, and have the option to download a ZIP of all the multimedia files.
...
- If you have not yet uploaded any files, after clicking on "Show Only Missing References" you will see a list of images that still need to be added:
2. The manager alerts you that each file is missing, and you will need to select the orange red button "Upload Image." There is one row for each missing file. After clicking on "Upload Image" you will see something like this:
3. Click on "Select File" to find the appropriate file on your computer.
4. After you select a file, you will have the option to "Select another file" if it was not the correct file or to "Begin Upload."
5. After you have uploaded the media file, your list will no longer have orange "missing" tags, but green "found" tags. It should look more like this:
6. As you can see, your options from the Multimedia Manager have now changed. You can preview the file by selecting "View Larger," to open the file in a new window (you'll have to open a new window to hear an uploaded audio file!). If you want to change the image, click on "Replace Image" and follow the same instructions as before.
...
- Label your multimedia files with the relevant question ID eg. if question ID=woman_name, then label the audio/image file as woman_name
- Once all your multimedia files are correctly labeled (with the relevant question ID), you now have the option to bulk upload your files (images/audio/video)
- Place all your images/audio files into a directory structure that mirrors the file path
- You can see the file path in the Media section of the form builder by clicking on Advanced Show path (see below)
- In the example below, the file path for the audio file is file/commcare/audio/data/show_edd
- In the below example, the file path for the image files is file/commcare/image/data/show_edd
- You can see the file path in the Media section of the form builder by clicking on Advanced Show path (see below)
5. Click on Multimedia tab in the setting section of CommCare HQ (see below)
6. You can now click on multimedia reference checker.
8. Now click on Select Files and then Begin upload (see below)
Bulk uploading multimedia for an app with multiple languages:
1. Go to the media section for a relevant question in your form
2. Click on the relevant section audio/video and you will see something like the below
(You will notice that the file path for the audio file is the same for French and English)
3. You will need to modify the file paths for the audio files in the form
You should then be able to follow the steps above for bulk upload!
STEP 3: Download Your Media Files!
- On the main application page under "Multimedia"
- In the Multimedia Manager main page (see above)
- In the release manager of your application after clicking "deploy"
The file will be downloaded as a ZIP and you will have to unzip the file in order to use it. By storing and transmitting it as a ZIP is a good idea so that you don't lose any of those media files!
Important Notes:
- Other media types, such as video, are not currently supported by the Multimedia Manager. These will have to be uploaded by adding a link to the file in the form, and then manually putting the correctly named file in the right place.
- If you change the name of a question ID, the file-path will not automatically update. You can keep using the old file-path and any media you had previously uploaded. If you want to use the new question id in the file-path, you will need to delete the reference and add it again, then go back to the multimedia manager to upload the media file again.
- The multimedia manager is not directly related to the release manager, it is related to the application in its current state. This means that if you make a lot of changes to an application and download an old build, the multimedia manger will still reflect the current state of the application (most recent build).