Videoplayer Plugin videoplayer.swf / videoplayer.js Version 1.16

Select Version:

• 1.21
• 1.20.11
• 1.20.10
• 1.20.9
• 1.20.8
• 1.20.7
• 1.20.6
• 1.20.5
• 1.20.4
• 1.20.2
• 1.20.1
• 1.20
• 1.19-pr16
• 1.19-pr15
• 1.19-pr14
• 1.19-pr13
• 1.19-pr12
• 1.18.1
• 1.17
• 1.16
• 1.0.8.15
• 1.0.8.14
• 1.0.8-beta

• The Videoplayer plugin can be used to play videos inside krpano...
• as normal flat video (via plugin element)...
• or as flat or 3D distorted hotspot (via hotspot element).
• See also the HTML5 / iOS (iPhone/iPad) notes.
• For converting the videos to a formats that are playable by all browsers and devices, the free Open-Source tool Miro Video Converter is recommended.

Syntax

<plugin name="video1"
        url="videoplayer.swf"
        alturl="videoplayer.js"
        videourl="video.m4v|video.webm|video.ogv"
        posterurl="videoposter.jpg"
        align="center" x="0" y="0"
        pausedonstart="false"
        loop="false"
        volume="1.0"
        buffertime="0.1"
        ignoremetadata="false"
        updateeveryframe="true"
        onvideoready=""
        onvideopaused=""
        onvideocomplete=""
        onunsupported=""
        />

<hotspot name="video1"
         url="videoplayer.swf"
         alturl="videoplayer.js"
         videourl="video.m4v|video.webm|video.ogv"
         posterurl="videoposter.jpg"
         ath="0.0" atv="0.0"
         distorted="true"
         scale="1.0" 
         rx="0.0" 
         ry="0.0" 
         rz="0.0" 
         volume="1.0"
         directionalsound="true"
         range="90.0"
         rangefalloff="1.0"
         outofrangevolume="0.0"
         onvideoready=""
         onvideopaused=""
         onvideocomplete=""
         onunsupported=""
         />

Plugin Attributes

• videourl
  • The url of the video file.
    Note - the video url must be always relative to the main krpano swf file!
  • The Flashplayer and the HTML5 Browsers are having a different level of video formats/codecs support.
    Typical video formats are:
    • MPEG4/H264 (.mp4, .m4v) - Flashplayer / Safari / Chrome / IE
    • Flash Video (.flv, .f4v) - Flashplayer
    • WebM - Chrome / Firefox
    • Ogg Theora (.ogg, .ogv) - Firefox
    To provide several video formats and let the plugin automatically choose the appropriate one, set the paths to all video files at once and separate them by a pipe | character.
  • Transparent videos with alpha-channel are possible (Flash and VP6 codec only).
• posterurl (optionally, HTML5 only)
  • This is the url to an image that should be shown until the video is started to play.
  • For videos on iPhone and iPad using this setting is highly recommended - see the HTML5 / iOS (iPhone/iPad) notes for more details.
  • The size of this image will be used as size of video.
• pausedonstart   (optionally)
  • Should the video be paused at the start.
  • true or false, default=false
  • Note - on iPhone / iPad the video will be always paused on start!
• loop   (optionally)
  • Should the video loop or stop at end.
  • true or false, default=false
• volume   (optionally, Flash only)
  • Volume of video sound.
  • 0.0 - 1.0, default=1.0
• directionalsound   (optionally, Flash only)
  • Use directional 3D sound when the video is played as hotspot.
  • true or false, default=true
• range   (optionally, Flash only)
  • Range of the directional sound, distance of the viewing look direction to the sound position, the sound volume will fall off withhin this distance from volume to outofrangevolume.
• rangefalloff   (optionally, Flash only)
  • The 'falloff' factor, defines the volume falloff curve (e.g. ~0.01 to ~10.0), default=1.0.
• outofrangevolume   (optionally, Flash only)
  • Out of range volume, default=0.0.
• buffertime   (optionally, Flash only)
  • The time in seconds that the video should be preloaded/buffered before starting to play, default=0.1 (=Flashplayer default).
• ignoremetadata   (optionally, Flash only)
  • The videoplayer uses the size information from the meta-data that was stored in the video file by default to determine the size/resolution of the video. But there are some videos and video-converter tools with wrong size information in the meta-data, which cause a distorted or wrong size. With that setting the that meta-data information can be ignored/skipped.
• updateeveryframe   (optionally, Flash only)
  • An advanced setting for special performance optimizations - use with care!
  • It has only an effect when the video is played as distorted hotspot!
  • true or false, default=true
    The video frame will be only refreshed/updated when flash reports "there is a new frame", this reduces the cpu load but in situations where the Flashplayer has much work to do, this can cause frame skipping (e.g. while moving in the pano).

Plugin Attributes - Events

• onvideoready   (optionally)
  • Will be called when the video is ready for playing.
  • That means there are all basic information about the video there, it's frame size and the length (totaltime).
• onvideopaused   (optionally)
  • Will be called when the video will be paused (a pause through pausedonstart will be ignored).
  • Note - in the krpano HTML5 Viewer this event will be also called when the video has ended, just before the onvideocomplete event.
• onvideocomplete   (optionally)
  • Will be called when the video was played completely.
  • Happens only when "loop" is set to "false".
• onunsupported   (HTML5 only, optionally)
  • This event will be called when playing HTML5 videos is not supported by the browser.
  • When this event is not set and HTML5 video are not supported then a warning message will be shown in the krpano log.

Plugin Dynamic Read Only Attributes

• isvideoready  
  • Check if the video is ready for playing.
  • true or false
• ispaused  
  • Check if the video is currently paused.
  • true or false
• iscomplete  
  • Check if the video has ended.
  • true or false
• time  
  • The current video position in seconds.
• totaltime  
  • The length / totaltime of the video in seconds.
• loadedbytes   (Flash only)
  • The currently loaded bytes of the video file.
• totalbytes   (Flash only)
  • The total bytes of the video file.

Plugin Actions

• playvideo(url)
  • Opens a new video stream and starts playing it.
  • A currently playing video will be stopped and closed in this case.
  • Note - the video url must be always relative to the main krpano swf file!
• closevideo()
  • Stops the video and closes the video stream.
  • Resuming or playing again ist not possible.
• stop()
  • Stops the video and moves to the first frame and pauses there.
  • The video can be resumed via play() or resume()
• play()
  • Resumes a paused or stopped video.
• pause()
  • Pauses the video at the current frame.
  • The video can be resumed via play() or resume().
• resume()
  • Resumes a paused or stopped video.
• togglepause()
  • Pauses OR resumes the video.
• seek(time)
  • Seek to the given time position in seconds.

HTML5 and iOS (iPhone / iPad) Notes

videourl="video.m4v|video.webm|video.ogv"

iOS (iPhone / iPad) Notes

Examples