Shortcuts - a JW Player plugin

-

Description

Keyboard shortcuts for JW Player.

Keyboard Shortcuts

Space

Toggle play/pause.

Left/Right

Seek back/forward a certain amount of seconds. The default is to adjust the step size according to the duration of the video. This can be changed by setting the shortcuts.step or shortcuts.steps flashvars.

Since Flash can only seek to a keyframe in the video, the accuracy of this operation depends on the encoding of the video; it will end up on the closest keyframe. In case the closest keyframe to the frame you want to seek to is the same as the current frame, the plugin will extend the seek in the direction you want to go until it finds another keyframe. It will also try to prevent you from seeking past the end of the video (to avoid resetting the player or skipping to the next clip). But this is not always possible.

You can modify the step size by using Shift (x2), Ctrl (x4) and Shift+Ctrl (x1/4). On a Mac you shold use the Command key instead of Ctrl.

. (dot)

Step advance. This advances the playhead between 1/10 and 2/10 of a second. Not frame advance but somewhere up the same alley.

: (colon)

Slow motion, or continuous step advance. Leave slow motion by pressing any key. Slow motion must be enabled by setting the shortcuts.slowmotion flashvar to 'true'.

R

Restart the video from the beginning.

Up/Down

Increse/decrese volume.

M

Mute/unmute.

F

Enter fullscreen. You can also use the Esc key to toggle fullscreen on/off.

N or >

Next item in playlist.

P or <

Previous item in playlist.

Flashvars

shortcuts.step

Step size in seconds. This is how far the left/right keys will seek. See also shortcuts.steps.

shortcuts.steps

Step size in number of steps. The step size will be adjusted according to the length of the video. The video is divided into this many steps. For a 2 minutes long video a steps of 10 will result in a step size of 12 seconds. This is an alternative to the shortcuts.step falshvar. Default is 10 steps.

shortcuts.minstep

Minimum step size when using the shortcuts.steps flashvar. Default is 5 seconds.

shortcuts.maxstep

Maximum step size when using the shortcuts.steps flashvar. Default is 30 seconds.

shortcuts.slowmotion

Enable slow motion by setting this flashvar to 'true'. Please read the remarks below before enabling this feature.

shortcuts.slowmotionvolume

Volume while in slow motion (0-100). Default is 1. If you set volume to 0 (zero) you will most likely get a mute icon displayed on screen (which kind of ruins the experience).

Remarks

Analytics

If you are using the Your Analytics plugin you should not enable slow motion. Because of the way slow motion is implemented (and the way Your Analytics is treating events) it will result in a huge amount of PLAY and PAUSE events sent to your Your Analytics backend script. This might also be the case for Google Analytics, Count Trackula and other analytics plugins.

Files

SWF | FLA | AS

Licence

GNU GPL

Ideas for next version (2)

Description

In- and out-points, markers and A/B repeat.

New Keyboard Shortcuts

I

Set in-point.

O

Set out-point.

Shift-I

Goto in-point.

Shift-O

Goto out-point.

Ctrl/Cmd-I

Clear in-point.

Ctrl/Cmd-O

Clear out-point.

P

Play from in-point to out-point then stop.

Shift-P

Play repeatedly from in-point to out-point.

M

Add marker.

Ctrl/Cmd-M

Goto and delete closest marker.

Shift-n

Goto nth marker; where n is 1-9.

Shift-0 (zero)

Goto last marker.

Shift-Down

Goto next marker.

Shift-Up

Goto previous marker.

Altered keyboard shortcuts

U

Mute/Unmute.

>

Next item in playlist.

<

Previous item in playlist.

New Flashvars

shortcuts.in

In-point.

shortcuts.out

Out-point.

shortcuts.markers

List of marker positions separated by comma.

shortcuts.jshandler

Name of javascript handler. The handler is a function with parameters event and dataObject.

Javascript Events

SET

An in/out-point or marker was set.

Data:
type One of: in, out, marker
time Time (position)

CLEAR

An in/out-point or marker was cleared.

Data:
type One of: in, out, marker
time Time (position)

PLAY

A keyboard initiated change of play state.

Data:
state True=playing, false=paused
mode One of: play, play-repeat, inout, inout-repeat
time Time (position)

Remarks

Note that the keyboard shortcut for mute/unmute has changed from M to U, and that N and P are no longer shortcuts for next/prev item in playlist.

Setting or clearing/deleting an in-point, out-point or marker sends a javascript event. This allows a script to catch any changes, and can be used to display the current in/out-points and markers.

Visual feedback of in/out-points and markers would be interesting but this is currently not part of the proposal. This would also depend on the skin used.

The new keyboard shortcuts are based on Final Cut Pro.

Seeking funding.

Deadline for this version

After lunch, before Christmas.