This page last changed on Sep 07, 2011 by pwatson.
Using multimedia files you can display movies, animations and videos, and embed audio files on your Confluence page. There are several methods for attaching files to a page. Once you have attached the multimedia file to a Confluence page, you then edit the page to set where the multimedia content should appear. In the example below, we display a Flash file that is attached to this page.
Confluence supports the following multimedia formats: - Adobe Flash (.swf)
- Apple QuickTime (.mov)
- Windows Media (.wma, .wmv)
- Real Media (.rm, .ram)
- MP3 and MP4 files (.mp3, .mp4)
- MPEG files (.mpeg, .mpg)
- AVI files (.avi) You may need to enable an avi decoder within your browser.
| |
 | Quick guide to displaying multimedia content on a page
Choose one of these methods: - Add the macro yourself: Attach the multimedia file to the page in the usual way. Add the Multimedia macro using the macro browser.
- Autocomplete: Attach the multimedia file to the page in the usual way. Type '!' in the editor and choose the multimedia file from the list that appears.
- Drag and drop: Drop the video or other file into the editor. Confluence will attach the file and insert the Multimedia macro for you.
- Adjust parameters if necessary: Click on the Multimedia macro placeholder to set options for the macro, such as adjusting the width or height of the display, or setting autoplay on.
|
Displaying a multimedia file attached to the pageOnce you have attached a multimedia file to a page, there are different methods for choosing where on the page the multimedia content should appear: Inserting the Multimedia macro yourselfYou can add the Multimedia macro to the page yourself using the Macro Browser. This allows you to display a multimedia file that is attached to either the current page or to another page in the Confluence site. To insert the Multimedia macro on the page at the current cursor position:
- In the Confluence editor, choose Insert > Other Macros.
- Find and select the required macro.
Using autocompleteOnce a multimedia file is attached to the page, you can use autocomplete, while editing the page, to choose where the multimedia content should appear. To position an attached multimedia file on the page using autocomplete: - While editing the page, position the cursor where you want to place the multimedia content.
- Trigger the autocomplete function by typing '!'.
- Choose the multimedia file from the list that appears.
- If necessary, click on the Multimedia macro placeholder and choose Edit to set various options such as the width, height or autoplay.
Using drag-and-dropDepending on the browser you are using, you can attach and position a multimedia file in one step using drag-and-drop. To attach and position multimedia content using drag-and-drop: - While you are editing a page, simply drag-and-drop the multimedia file on to the page. Confluence will attach the file to the page and insert the Multimedia macro at the current cursor position for you.
- If necessary, click on the Multimedia macro placeholder and choose Edit to set various options such as the width, height or autoplay.
Multimedia macro parameters
When editing, you can click on the macro placeholder and choose Edit to display the parameters for this macro in the Macro Browser.
Parameters are options that you can set for Confluence macros to control the content or format of the macro output. The table below lists parameters for this macro that can be set in the Macro Browser. Parameter | Default | Description |
---|
Page Name | Current page | Name of the page to which the multimedia file is attached. If you are using the Macro Browser, just start typing the name of the page and then select it from the dropdown list that appears. The page can be in the same space or another space. | Attachment | None | File name of the multimedia file. | Width | If not specified, the browser will determine the width based on the file type. | Width of the movie window to be displayed on the page. By default, this value is specified in pixels. You can also choose to specify a percentage of the window's width, or any other value accepted by HTML. | Height | If not specified, the browser will determine the height based on the file type. | Height of the movie window to be displayed on the page. By default, this value is specified in pixels. You can also choose to specify a percentage of the window's height, or any other value accepted by HTML. | Autoplay | False | If this option is checked (that is, if the parameter is set to 'true') then the video or audio file will start playing as soon as the page is loaded. If this option is not checked (set to 'false') then the file will not play until the user clicks the icon or image on the page. See the note about autoplay below. |
Notes- The multimedia file must be attached to a Confluence page. For security reasons, files located on remote servers are not permitted. See the Widget Connector for displaying live content from external sites.
- You will need the relevant multimedia plugin for your browser. Your browser (Firefox, Internet Explorer, Safari and others) needs a plugin to play the video or audio file on a Confluence page. For example, to play a Flash movie you need the Flash plugin. Many plugins are shipped with the major browsers by default. If a user does not have the required plugin installed and enabled in their browser, they will not be able to view the multimedia files on the page.
- Autoplay may not always work as expected. You can set autoplay on, so that your video or audio file should start playing as soon as the page is loaded into the browser. (See parameters.) However, this setting may not always work as expected. Confluence will send an instruction to the browser plugin that plays the multimedia file. Different browsers and different media plugins behave in different ways, and not all of them respect such instructions.
- Use the Office Connector to display Office documents. Take a look at the Office Connector for embedding Word documents, presentations and other Office documents onto your Confluence page.
- If you get the error, 'Unable to embed content of type application/octet-stream', this means the MIME type is not recognised.
- Advanced users can try styling via CSS. By default, each embedded object is wrapped in a
div tag. If you wish to style the div and its contents, override the embeddedObject CSS class. Specifying an ID as a property also allows you to style different embedded objects differently. CSS class names in the format embeddedObject-ID are used.
Related TopicsWorking with Macros Widget Macro Working with the Office Connector Working with Attachments Take me back to Confluence User's Guide
|