The multimedia macro is used to embed attached video, animation and other multimedia files on a Confluence 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.

See the Widget Connector Macro if you want to display online multimedia content, such as YouTube and Vimeo videos on a page. 

ページに Multimedia マクロを追加するには、次の手順を実行します。

  1. Confluence のエディタで、[挿入] > [その他のマクロ] を選択します。
  2. 対象のマクロを見つけて、選択します。

Speeding up macro entry with autocomplete: Type { and the beginning of the macro name, to see a list of suggested macros. Details are in Using Autocomplete.

既存のマクロを編集する方法: マクロのプレースホルダをクリックして、[編集] を選択します。マクロのパラメータが編集可能な場合、マクロのダイアログ ウィンドウが開きます。

You can also drag a supported multimedia file directly on to the page. Confluence will attach the file and add the macro for you. 

パラメーター

Parameters are options that you can set to control the content or format of the macro output. Where the parameter name used in Confluence storage format or wikimarkup is different to the label used in the macro browser, it will be listed below in brackets (example).

パラメーター名

必須

既定

パラメーターの説明と指定可能な値

ページ名

(page / space)

はい

現在のページ

Name of the page to which the multimedia file is attached. Start typing the name of the page and then select it from list of suggested pages.

Include the spacekey if you want to specify a page in another space (for example MYSPACE:My Page Title)

添付ファイル

(name)

はい

なし

添付されているマルチメディア ファイルの名前。

幅

いいえ

指定されていない場合、ブラウザーはファイルの種類に基づいて幅を決定します。

ページに表示されるムービー ウィンドウの幅。デフォルトでは、この値がピクセルで指定されます。また、ウィンドウの幅のパーセンテージや、HTML で使用可能なその他の値を指定するよう選択することもできます。

高さいいえ指定されていない場合、ブラウザーはファイルの種類に基づいて高さを決定します。ページに表示されるムービー ウィンドウの高さ。デフォルトでは、この値がピクセルで指定されます。また、ウィンドウの高さのパーセンテージや、HTML で使用可能なその他の値を指定するよう選択することもできます。

Autoplay

(autostart)

いいえ

false

パラメータが true に設定されている場合、ページの読み込みが完了するとすぐにビデオまたはオーディオ ファイルの再生が開始します。このオプションが false に設定されている場合、ユーザーがページのアイコンまたはイメージをクリックするまでファイルは再生されません。

コー​​ドの例

次の例は、Confluence ページの基本的なマークアップを調べたり、編集したりする上級ユーザー向けに提供されています。 

マクロ名: multimedia

マクロ本文: なし。

保存形式の例

<ac:structured-macro ac:name="multimedia">
  <ac:parameter ac:name="width">500</ac:parameter>
  <ac:parameter ac:name="name">
    <ri:attachment ri:filename="Ninjas.MOV"/>
  </ac:parameter>
</ac:structured-macro>

Wiki マークアップ例

{multimedia:space=DOC|page=My macros|name=ninjas.swf|autostart=true}

注意

  • You will need the relevant multimedia plugin for your browser. Your browser may need a plugin to play the video or audio file on a Confluence page.
  • Autoplay may not always work as expected. Some browsers may not autoplay the attached file. 
  • 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.

  • ラベルなし