Adding Video, Audio, and Embedded HTML Resources

You can insert references to media resources (such as videos, audio clips, or embedded HTML frames) in your DITA, DocBook, or XHTML topics. The media resources can be played directly in Author mode and in all HTML5-based outputs. There is a toolbar button () that allows you to insert and configure a reference to the media resource. You can also drag media files from your system explorer or the Project Explorer view and drop them into your documents (or copy and paste them).

Table 1. Supported Media Types
Media	Description	Type	Supported Size Properties
mp3	Moving Picture Experts Group Layer-3 Audio	audio	Width
wav	Windows Wave	audio	Width
pcm	Pulse Code Modulation	audio	Width
m4a	Moving Picture Experts Group Layer-4 Audio	audio	Width
aif	Audio Interchange Format	audio	Width
mp4	Moving Picture Experts Group Layer-4 Video	video	Width & Height
m4v	iTunes Video File	video	Width & Height
avi	Audio Video Interleaved	video	Width & Height
embedded video (such as YouTube, Vimeo, or Vidyard)	Embedded Iframe Code	iframe	Width & Height

Adding a Media Resource

To insert a media resource in a document, use the following procedure:

Place the cursor at the location where you want the media resource.
Select the Insert Media Resource action from the toolbar. A Chose Media dialog box appears.
Note: You can also drag media files from your system explorer or the Project Explorer view and drop them into your documents (or copy and paste them).
Select the URL for the media resource and click Ok.

Result in Author Mode: A reference to the specified media object is inserted and rendered in Author mode so that it can be played directly from there.

Attention:

On Ubuntu 17.10, if you receive an error when trying to play videos in Author mode, you need to install the libavformat57 library.

Result in Output: In the publishing stage, the media object is converted to an HTML5 element so that it can be rendered properly and played in all HTML5-based outputs.