Xan: Protected "Media" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2023-05-28T14:58:00Z

Protected "Media" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision	Revision as of 16:58, 28 May 2023
(No difference)

Xan: Created page with "{{feature|N/A|3.6}} Preparing to view media inside [[DeltaWorlds]] [[Image:Media2.jpg|300px|thumb|Clicking on one of the buttons to the right initiates the [http://www.youtube.com/watch?v=q26rqNGFA-E Alphaworld Exploration Demo Video] on the screen in-world]] The ''media'' command allows the playback or interaction of a Windows Media Player compatiable media file. Audio and video can be played on any object but video and the OSD is only..."

2023-05-04T20:11:09Z

Created page with "{{feature|N/A|3.6}} 300px|thumb|Preparing to view media inside [[DeltaWorlds]] 300px|thumb|Clicking on one of the buttons to the right initiates the [http://www.youtube.com/watch?v=q26rqNGFA-E Alphaworld Exploration Demo Video] on the screen in-world The ''media'' command allows the playback or interaction of a Windows Media Player compatiable media file. Audio and video can be played on any object but video and the OSD is only..."

New page

{{feature|N/A|3.6}}
[[Image:Media1.jpg|300px|thumb|Preparing to view media inside [[DeltaWorlds]]]]
[[Image:Media2.jpg|300px|thumb|Clicking on one of the buttons to the right initiates the [http://www.youtube.com/watch?v=q26rqNGFA-E Alphaworld Exploration Demo Video] on the screen in-world]]

The ''media'' command allows the playback or interaction of a Windows Media Player compatiable media file. Audio and video can be played on any object but video and the OSD is only visible on surfaces tagged as 100 (sign) or 200 (picture). Playlists can be played since version 6.0 browser build 1356, when Microsoft's WMP and DirectShow were replaced by VideoLan's VLC.

==Usage==
'''media''' [url=]''url'' [''text''] [name=''name''] [set OR pause OR stop] [color=''color'']
[bcolor=''bcolor''] [res=''res''] [fx=''fx''] [radius=''radius''] [radoff=''radoff'']
[vol=''vol''] [loop=''loop''] [osd=''osd''] [ext=''ext''] [nostop] [nocache]

===url===
The required ''url'' parameter is a web address or local path to the media file. If the url is empty and a name is specified, it will stop running media on all objects with the given name. The url's prefix defaults to "http://" if no other protocol is specified.

The ''url='' parameter identifier is only required if a ''text'' value is given.

===text===
''text'' is a [[Object scripting#String|string]] to display whilst playing media. If omitted, the text defaults to the contents of the object's description field.

===name===
''[[name]]'' specifies the name of the same owner's object to place the media on. <sup>5.0</sup> If specified as "aw_3d", the media will play in a centered overlay on the viewport, with controls to set the opacity, minimize and close the overlay.

===set===
''set'' changes the attributes of an already playing media on the fly, without pausing or stopping the stream. Resolution cannot be changed on the fly.

===pause===
''pause'' is used to pause running media. Triggering a subsequent pause causes the media to continue playing where it was paused before. Live feeds continue streaming in the background but rendering and audio is paused.

===stop===
''stop'' stops an object's playing media.

===color===
''color'' specifies the [[Object scripting#Color|color]] to use for the OSD text.

===bcolor===
''bcolor'' specifies the [[Object scripting#Color|color]] to use for the background of the OSD.

===res===
''res'' specifies resolution used to the displayed video frames in pixel, if the media contains a video. Valid values are 64, 128, 256 (default) and 512 pixels. The proportions of the video (height and width) only depends on the sign's proportions and not on the used resolution.

===fx===
''fx'' specifies a sound effect to apply to the media. The only option is ''3d''; this causes the sound to pan according to the avatar's position.

===radius===
''radius'' specifies the maximum radius in meters the media can be heard. The default radius is 30 meters.

===radoff===
''radoff'' specifies the maximum radius in meters the media stream will play. The default radoff is 30 meters. ''radoff'' cannot be smaller than ''radius''. Going beyond this radius stops the media.

===vol===
''vol'' specifies the relative volume of the played sound in percent. Valid values are in the range from 0 to 100, where 0% is muted and 100% is full volume. Default is 100%.

===loop===
''loop'' specifies the count of loops to play the specified media file. Valid values are in the range from 1 to 2147483647. Default is 1.

===osd===
''osd'', also known as ''on-screen display'', is a [[Object scripting#Boolean|boolean]] parameter that specifies if a TV-like on-screen-display should be displayed on top of the video frames.

===ext===
''ext'' is a [[Object scripting#Boolean|boolean]] parameter which forces the video to play in an external window. If the media only contains audio, no external window is displayed.

===nostop===
''nostop'' prevents mouse clicks from stopping media. Objects using the bump trigger always have this option set, to avoid subsequent on/off triggering of the media command. In conjunction with the activate trigger, this disables the toggle-switch-function, which is applied on media signs by default. When used with the create trigger the nostop argument has no effect.

===nocache===
''nocache'' prevents files with an extension .mp3 or .wav from been cached. This will allow, eg. special configured icecast streams that use a file name and an extension in an url, to be streamed instead of downloaded to cache. Use this option only, if you are certain the server is media streaming server. Note, if the ''nocache'' option is not given, ie forgotten, caching of a .mp3 or .wav can not be interrupted until a stream error or an end of file condition has been reached, and the cached version will be replayed on any later access. The option was added to version 6.4 build 1512.

==Examples==
create media umpd.umd.edu/sirens/video/Windows/EWdownload.wmv
This creates and plays the given media stream as soon the used sign object comes within your avatar's view range.

Object #1:
create sign color=orange, name foo
Object #2:
activate media name=foo umpd.umd.edu/sirens/video/Windows/EWdownload.wmv
This creates an empty sign object at first. As soon the activate command on the other object is triggered, the given media stream is displayed on the sign object named foo.

create sign bcolor=red; activate media 212.109.3.19:8000
This creates an object that when clicked on, starts the media, and when clicked on the second time it switches it off again.

Object #1:
create sign, name foo, solid off; bump media 212.109.3.19:8000
Object #2:
create sign, name foo; bump media stop name=foo
If your avatar collides with the first object, it will start the media. When colliding with the other object it stops the running media.

Object #1:
create sign, name foo; activate media 212.109.3.19:8000
Object #2:
activate media pause name=foo
This creates and plays the given media stream which can be paused by clicking the other object.

Object #1:
create sign, name foo; activate media url=212.109.3.19:8000
Object #2:
activate media set vol=50 osd=off name=foo activate media set vol=100 osd=on name=foo
This will change the parameters of an already playing media.

==Notes==
* Playback of some files is subject to the codecs installed on the user's system. The safest formats to use are .wmv and .wma for video and audio, respectively.
* Media playback may be disabled in the browser's [[Settings]], within the ''Downloads'' tab.
* On a world level, media playback may be prevented from being triggered by [[create]] in the Options section of the [[World]]'s features.

==External links==
* '''[http://www.videolan.org VideoLan's VLC]''' - Official website for references
* '''[http://www.microsoft.com/windows/windowsmedia/default.mspx Windows Media Player]''' - Official website for download (obsolete since v6.0.1356)

{{Build}}
[[Category:Building commands]]
[[Category:3.6]]
[[nl:Commando:Media]]

Media - Revision history

Xan: Protected "Media" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))