Page tree
Skip to end of metadata
Go to start of metadata

EditLive! supports embedding of media content from social media services and other web-based media services via the Insert Media dialog.

The Insert Media dialog supports adding content from these services in two ways.  For services that support the oEmbed specification EditLive! can be configured to automatically fetch the required HTML from those services.  For other services, the Insert Media dialog supports the insertion of an arbitrary HTML fragment to represent rich media.

For media to be supported via the Media Services portion of the Insert Media dialog the oEmbed service associated with that service must be configured for use with EditLive!.

While EditLive!'s default configuration is pre-configured to support several popular media services including YouTube, Vimeo, Flickr and SlideShare, it's recommended that a commercial media aggregator service like embed.ly be used in conjunction with this functionality to provide a large breadth of services support.  For more information see the article on Using a Media Aggregator Service.

EditLive! supports all four oEmbed types in the specification; photo, video, link and rich.

 

Note

  • The oEmbed "link" type is inserted as a plain hyperlink with no additional information. Editing these hyperlinks is done through the standard hyperlink dialog.
  • The oEmbed "photo" type is inserted as an image with no additional information. These images are editable with the built in image editor and their properties can be adjusted using the Image Properties dialog.

Endpoints and URL scheme matching information must be provided for each service provider. This documentation is usually available from the service provider directly.

Media objects embedded within EditLive! are presented to the user in uneditable sections to preserve the output format returned by the service provider. Each section uses an overlay to indicate the type of oEmbed media that has been inserted. The icons can be seen below:

 Used to represent rich, interactive and social media.  Includes services such as SlideShare, Google Maps and Twitter.

 Used to represent video media.  Includes services such as YouTube, Vimeo and Brightcove

Configuration

Menu and Toolbar Item

To provide the Insert Media menu item or toolbar button, the value InsertMedia must be specified for the name attribute of either a <menuItem> or <toolbarButton> configuration file element. For more information on EditLive! for Java configuration files, see the Instantiating the Applet article. For more information on creating menu or toolbar items, see the Setting Menu and Toolbar Items and Menu and Toolbar Item List articles.

Services Configuration

Configuration of media content is provided via the <multimedia> element within an EditLive! configuration file. A separate <service> configuration file element must be provided for each oEmbed service to be used with EditLive!. Types are evaluated in order, to allow for prioritisation of ambiguous schemes and fallback services to be specified as a last resort.  The first match that is encountered will be used to fetch the media asset.

The scheme attribute is used to specify the format of the URLs that match to the service and its oEmbed endpoint.  For more information about oEmbed schemes and endpoints see the oEmbed specification.

The sample configuration that ships with EditLive! - sample_eljconfig.xml - includes configuration to use over 20 different services.  You can also use a 3rd party oEmbed service like embed.ly to provide further oEmbed functionality.  For more information on using an external oEmbed aggregator see the Using a Media Aggregator Service documentation.

Example
The following example would ask youtube.com for how to insert YouTube videos, and embed.ly for all other links.

 

<editLive>
   ...
      <mediaSettings>
         ...
            <multimedia>
              <services>
                ...
                <service name="YouTube" endpoint="http://www.youtube.com/oembed" scheme="http://*.youtube.com/*" />
                <service name="Embed.ly" endpoint="http://api.embed.ly/1/oembed?key=<your key here>" scheme="*" />
                ...
              </servies>
            </multimedia>
         ...
      </mediaSettings>
   ...
</editLive>
  • No labels