Media Work All In One

Pautinka / Документация

Media Work All In One

Живое видео, звук и рабочие кнопки в Unreal Engine.

Выведите ролик на монитор, покажите прозрачный MOV как голограмму или дайте игроку подойти к экрану и нажать паузу.

Unreal Engine 5.3–5.8 · Windows 64-bit · 1.0

Установка из Fab

Media Work All In One работает на Windows 64-bit в Unreal Engine 5.3–5.8.

  1. Добавьте плагин в библиотеку Fab. Войдите в Epic Games Launcher под той же учётной записью. Закройте Unreal Editor.
  2. Откройте Unreal Engine > Library > Fab Library и нажмите Install to Engine. Выберите версию движка вашего проекта.
  3. Включите Media Work в Edit > Plugins. После перезапуска откройте Tools > Pautinka > Media Work. Проиграйте деморолик и проверьте картинку и звук.

Скачать краткое руководство на английском

Импорт и замена файлов

  1. Выберите «Из Content Browser» для готового ассета или «С диска», чтобы добавить локальный файл. Поддерживаются MP3 и совместимые MP4 и MOV. Для обычного MP4 подойдут H.264 и звук AAC.
  2. Откройте нужную вкладку, проверьте файл в предпросмотре, настройте и сохраните ассет.
  3. Для замены щёлкните правой кнопкой по источнику в Content Browser и выберите Reimport. Снова проверьте ролик в прежнем плеере.

Для сборки игры держите импортированный файл в проекте. Если ролик не открывается, проверьте, чем закодированы его видео и звук.

Живое видео и звук в материале

Материал показывает картинку, а Media Work воспроизводит звук из той же сессии. Когда вы ставите ролик на паузу или перематываете, картинка и звук меняются вместе.

  1. В «Видео в текстуру» выберите клип, запустите предпросмотр и сохраните текстуру.
  2. Добавьте в Material Editor ноду Media Work Video Texture. Для светящегося экрана выберите Unlit и подключите RGB к Emissive Color.
  3. Создайте экземпляр материала, назначьте сохранённую текстуру параметру MediaWorkVideo и примените материал к мешу. Для виджета используйте материал для UI.
  4. Для ручного запуска вызовите Start на видеотекстуре в Blueprint. Пауза, остановка, перемотка и громкость управляются через ту же сессию или контроллер.
Media Work Video Texture · RGB → Emissive Color · Opacity → Opacity
Media Work Video Texture · RGB → Emissive Color · Opacity → Opacity

Прозрачный MOV и маски

  1. Откройте MOV с альфа-каналом, например ProRes 4444 с включённой альфой. Проверьте ролик на контрастном фоне.
  2. В материале выберите Translucent. Подключите RGB для изображения, а выход Opacity ноды к входу Opacity материала.
  3. Для мягкого края выберите одну из 50 масок в «Видео в текстуру». У чёрно-белой картинки используйте канал Red, у прозрачного PNG — Alpha. Белый или полная альфа оставляют изображение, чёрный или нулевая альфа скрывают.
  4. Оставляйте центр своей маски цельным, а плавный переход заканчивайте до края картинки. Маска сочетается с исходной прозрачностью и применяется к отдельной видеотекстуре.
ProRes 4444 · Alpha
ProRes 4444 · Alpha
Video texture · Soft Lens
Video texture · Soft Lens

Полный видеоплеер

  1. В «Видео плеер» выберите файл и оформление. Screen показывает плеер на экране, Plane размещает его на плейне, Texture выдаёт картинку вместе с рамкой и кнопками для материала.
  2. Оставьте пропорции на «Авто» или укажите ширину, делённую на высоту. Масштабируйте и смещайте видео внутри рамки. Заголовок можно оставить пустым.
  3. Сохраните плеер и вызовите Open Saved Player в Blueprint. Сохраните ссылку на результат, чтобы получить поверхность, текстуру и сессию или закрыть плеер.
  4. Для своего материала возьмите текстуру через Get Output Texture. Включите отрисовку кнопок, если они нужны на самой текстуре.
Media Work · Video player
Media Work · Video player
Open Saved Player · Screen / Plane / Texture
Open Saved Player · Screen / Plane / Texture

Кнопки и адресное управление

  1. Передайте поверхность плеера в Configure Media Work Player Controls. Выберите курсор или кнопки, персонажа и максимальную дистанцию.
  2. На плейне можно использовать луч. Для своего меша передавайте координаты указателя через Update Pointer UV. X и Y идут от 0 до 1 по текстуре. Передавайте нажатие и отпускание.
  3. Чтобы вынести управление в отдельный виджет, добавьте Media Work Controls и привяжите его к сессии или ID плеера. Выберите набор кнопок и их оформление.
  4. Проверьте на двух экранах. Пауза на одном не должна останавливать второй. При выходе из зоны удержание кнопки или перемотки должно завершиться.
Configure Media Work Player Controls
Configure Media Work Player Controls

Аудио и плейлист

  1. В «Аудио плеер» добавьте MP3 или импортированные источники. Выбирайте дорожки списком или кнопками предыдущего и следующего трека.
  2. Включите повтор или перемешивание, задайте громкость и настройте шесть полос от басов до верхних частот. Сброс EQ выравнивает все полосы.
  3. Выберите оформление, по желанию скройте название трека или список и сохраните плейлист.
  4. В Widget Blueprint добавьте Media Work Player и вызовите Open Playlist с сохранённым ассетом. Для своих кнопок используйте команды сессии.
Media Work · Audio playlist
Media Work · Audio playlist

Своя рамка и кнопки

  1. Сделайте копию готового стиля и ассетов его кнопок, если их тоже меняете. Откройте SVG-шаблон в графическом редакторе.
  2. Нарисуйте четыре угла, четыре стороны, верхнее и нижнее украшения при необходимости, две кнопки, дорожки и бегунки. Вокруг силуэтов оставьте прозрачность и запас места. Перед экспортом RGBA PNG скройте направляющие.
  3. Импортируйте PNG. Назначьте детали в Frame в порядке на шаблоне. Для атласа разделите координаты прямоугольника каждой детали на ширину и высоту всего изображения и впишите их в UV Min и UV Max.
  4. Сведите стороны с углами через Corner Anchors, Corner Arm Widths и Side Profiles. Corner Offsets задаются в процентах от размера угла, отрицательные X и Y смещают влево и вверх. Join Overlap заводит сторону под угол. Проверьте, что украшение целиком помещается на прозрачном холсте.
  5. Кнопка может сохранить цвет, получить общий оттенок или менять только выбранную часть. Белое на цветовой маске разрешает перекраску. Проверьте широкий, квадратный и вертикальный кадры и компактный аудиоплеер на светлой и тёмной подложках.
Media Work · Skin atlas
Media Work · Skin atlas

Субтитры

  1. Импортируйте SRT, VTT, ASS, SSA, TTML, DFXP или SBV. Откройте ассет и проверьте строки и время.
  2. В видеоплеере включите субтитры, назначьте дорожку и выберите язык, если их несколько.
  3. Подберите шрифт с нужными буквами, например Golos Text для кириллицы. Поправьте время смещением и сохраните плеер.
Media Work · Golos Text
Media Work · Golos Text

Эффекты видео

  1. Откройте «Эффекты видео», выберите ролик и пресет. Сравните с исходным видео на ходу.
  2. Настройте силу, цвет и другие доступные параметры. Оставьте Preserve Alpha включённым, если нужна прозрачность.
  3. Сохраните эффект. В Blueprint подключите его к сессии и используйте выходную текстуру в материале.
Video · Original
Video · Original
Video · Effect
Video · Effect

Камера в текстуру

  1. В «Камера» выберите камеру сцены и убедитесь, что в её кадре нужные объекты.
  2. Задайте размер текстуры, частоту обновления и при желании эффект. Сохраните настройки. Для небольшого охранного монитора можно снизить частоту.
  3. Добавьте Media Work Camera Texture в сцену или Blueprint. Назначьте камеру и настройки, передайте Get Output Texture в параметр материала или вызовите Apply to Material.
Media Work · Camera texture
Media Work · Camera texture
Media Work · Camera texture + effect
Media Work · Camera texture + effect

Качество вывода

  1. Прямой вывод использует исходный кадр. Включите обработку для изменения разрешения, фильтрации или альфы. У полного плеера отдельные разрешение и частота перерисовки.
  2. Включите сглаживание при масштабировании или выключите для пиксельной графики. 16 бит подходят для плавных переходов, 8 бит экономят память.
  3. Выберите частоту отдельно для видеотекстуры, плеера и камеры. Проверьте вид и звук там, где их увидит игрок.

Сборка игры для Windows

  1. Сохраните источники, материалы, плееры и стили, на которые ссылаются сцены и Blueprint. Проверьте включение ассетов, подгружаемых во время игры.
  2. Упакуйте проект под Windows 64-bit. Настройка делается в редакторе, сохранённый плеер работает в игре.
  3. В отдельном запуске проверьте первый кадр, звук, перемотку, прозрачность и нажатия. Если источник открывается только в редакторе, проверьте, попал ли он с зависимостями в сборку.

Справочник нод Blueprint

Откройте группу, выберите ноду и посмотрите назначение и пины на настоящем снимке Unreal. Подключение RGB и Opacity показано выше на снимке материала.

Названия нод, пины и подсказки в справочнике приведены как в английском интерфейсе Unreal.

MWCameraCaptureComponent · 13
Apply to Material

Connects the live picture to a texture parameter. The connection follows changes in output size.

MWCameraCaptureComponent.ApplyToMaterial
Apply to Material
Apply to Material
Close Camera

Stops capture and releases this camera's picture buffers and material connections.

MWCameraCaptureComponent.CloseCamera
Close Camera
Close Camera
Set camera texture settings

Creates a live camera texture with the saved size, update rate and effect.

MWCameraCaptureComponent.Configure
Set camera texture settings
Set camera texture settings
Update camera texture

Draws one new frame. Use this when automatic updates are paused.

MWCameraCaptureComponent.DrawFrame
Update camera texture
Update camera texture
Get Output Texture

Returns the finished live texture, or no texture while the camera is unavailable.

MWCameraCaptureComponent.GetOutputTexture
Get Output Texture
Get Output Texture
Choose source camera

Follows this camera. Leave empty to follow the player's camera during the game.

MWCameraCaptureComponent.SetCamera
Choose source camera
Choose source camera
Set Effect

Chooses a scene effect without opening a second camera. An empty choice restores the camera picture.

MWCameraCaptureComponent.SetEffect
Set Effect
Set Effect
Set Effect Color

Changes a named color or pattern placement in an effect part. Other cameras keep their own settings.

MWCameraCaptureComponent.SetEffectColor
Set Effect Color
Set Effect Color
Set Effect Strength

Sets how strongly the selected effect changes the picture, from zero to one.

MWCameraCaptureComponent.SetEffectStrength
Set Effect Strength
Set Effect Strength
Set Effect Value

Changes a named value in an effect part. Parts count from zero. Invalid names or values return false.

MWCameraCaptureComponent.SetEffectValue
Set Effect Value
Set Effect Value
Set Output Size

Changes the exact output size. Unsupported sizes are rejected, without silently choosing a smaller picture.

MWCameraCaptureComponent.SetOutputSize
Set Output Size
Set Output Size
Pause camera updates

Keeps the last frame without rendering the scene again until updates resume.

MWCameraCaptureComponent.SetPaused
Pause camera updates
Pause camera updates
Set Update Rate

Sets automatic updates per second, from 1 to 120. Pausing still keeps the last frame.

MWCameraCaptureComponent.SetUpdateRate
Set Update Rate
Set Update Rate
MWEffectPlayer · 10
Apply to Material

Connects the processed picture and its transparency to a texture parameter. The connection follows changes of effect and output size.

MWEffectPlayer.ApplyToMaterial
Apply to Material
Apply to Material
Close

Releases this effect's picture buffers and material connections. The shared player and its sound continue playing.

MWEffectPlayer.Close
Close
Close
Get Player Id

The ID of the shared player used by this effect.

MWEffectPlayer.GetPlayerId
Get Player Id
Get Player Id
Preserve Alpha

Keeps the original video's transparency. Turn off only when you want a solid rectangular picture.

MWEffectPlayer.PreserveAlpha
Preserve Alpha
Preserve Alpha
Draw video effect

Processes the current video frame and returns the finished texture.

MWEffectPlayer.Render
Draw video effect
Draw video effect
Change effect color

Changes a color in a pass of the selected effect.

MWEffectPlayer.SetColor
Change effect color
Change effect color
Set video effect

Applies this effect and its saved settings to the video.

MWEffectPlayer.SetEffect
Set video effect
Set video effect
Change effect value

Changes one setting in a pass of the selected effect.

MWEffectPlayer.SetScalar
Change effect value
Change effect value
Set Strength

Sets how strongly the effect changes the picture, from zero to one.

MWEffectPlayer.SetStrength
Set Strength
Set Strength
Use Session

Processes this player's live picture using its own playback clock. Sound and controls keep using the same player. An optional texture can supply its masked picture.

MWEffectPlayer.UseSession
Use Session
Use Session
MWMaskedVideoTexture · 10
Apply video to material

Connects this live texture to a texture parameter in a material.

MWMaskedVideoTexture.ApplyToMaterial
Apply video to material
Apply video to material
Close player surface

Stops drawing this texture.

MWMaskedVideoTexture.CloseVideo
Close player surface
Close player surface
Update masked video

Draw the current video frame and its edge fade into this texture.

MWMaskedVideoTexture.DrawFrame
Update masked video
Update masked video
Player ID

This session has its own unique ID. Use it to address only this player.

MWMaskedVideoTexture.GetPlayerId
Player ID
Player ID
Change edge fade

Apply a saved mask to this video texture. An empty choice restores the original video transparency.

MWMaskedVideoTexture.SetMask
Change edge fade
Change edge fade
Use edge fade

Switch the chosen mask on or off. The original video alpha is preserved.

MWMaskedVideoTexture.SetMaskEnabled
Use edge fade
Use edge fade
Reveal the faint edge

Zero preserves the painted fade. Higher values reveal more of its faint outer edge without cutting off the gradient.

MWMaskedVideoTexture.SetMaskSoftness
Reveal the faint edge
Reveal the faint edge
Set picture framing

Moves or scales the picture inside the video texture.

MWMaskedVideoTexture.SetVideoFraming
Set picture framing
Set picture framing
Start video texture

Starts live video directly in this texture.

MWMaskedVideoTexture.Start
Start video texture
Start video texture
Use existing session

Shows video from an existing playback session.

MWMaskedVideoTexture.UseSession
Use existing session
Use existing session
MWMediaController · 12
Close source

Closes this player’s source and sound. Its ID and texture remain available for reopening.

MWMediaController.Close
Close source
Close source
Finished video texture

Connect this texture to your material. It includes the chosen edge fade.

MWMediaController.GetOutputTexture
Finished video texture
Finished video texture
Player ID

This session has its own unique ID. Use it to address only this player.

MWMediaController.GetPlayerId
Player ID
Player ID
Open media

Opens a saved media asset and connects its sound to this game world.

MWMediaController.OpenMedia
Open media
Open media
Pause

Pauses playback and keeps its position.

MWMediaController.Pause
Pause
Pause
Play

Starts or resumes the current track.

MWMediaController.Play
Play
Play
Seek

Moves to a time in seconds. Returns false when the source cannot seek.

MWMediaController.Seek
Seek
Seek
Set picture framing

Resizes and moves only this controller’s video inside its fixed output. After the first change, get Output Texture again and assign it to your material or UI: framing may create a processed output. The sound and session stay the same.

MWMediaController.SetVideoFraming
Set picture framing
Set picture framing
Change edge fade

Apply a saved mask to this video texture. An empty choice restores the original video transparency.

MWMediaController.SetVideoMask
Change edge fade
Change edge fade
Set volume

Sets this player's volume from 0 for silent to 1 for full volume.

MWMediaController.SetVolume
Set volume
Set volume
Stop

Stops playback and returns to the beginning. The source stays selected.

MWMediaController.StopPlayback
Stop
Stop
Play or pause

Pauses a playing track or resumes a paused track.

MWMediaController.TogglePlayback
Play or pause
Play or pause
MWMediaSession · 33
Can seek

Reports whether the source can jump to a chosen time.

MWMediaSession.CanSeek
Can seek
Can seek
Change track

Use 1 for the next track, -1 for the previous track and 0 to restart the current track.

MWMediaSession.ChangeTrack
Change track
Change track
Close source

Stops playback and releases the decoder and sound. Reopen Source can open it again.

MWMediaSession.Close
Close source
Close source
Find player by ID

Finds only the matching player in this game world. An unknown ID returns no player. Connect the result to Play, Pause or another command.

MWMediaSession.FindPlayerById
Find player by ID
Find player by ID
Source duration

Returns the length in seconds, or zero while it is unknown.

MWMediaSession.GetDuration
Source duration
Source duration
Get six-band gains

Six bands from bass to treble. Zero keeps the original sound; positive values boost and negative values reduce the band. Each track keeps the chosen settings. A band can only affect frequencies present in the recording.

MWMediaSession.GetEqualizer
Get six-band gains
Get six-band gains
Does playlist repeat

Tells you whether the playlist starts over.

MWMediaSession.GetPlaylistRepeat
Does playlist repeat
Does playlist repeat
Is shuffled

Tells you whether the playlist plays in shuffled order.

MWMediaSession.GetPlaylistShuffle
Is shuffled
Is shuffled
Playback position

Returns the current time in seconds for a clock or progress bar.

MWMediaSession.GetPosition
Playback position
Playback position
Get current subtitle lines

Returns the lines at this player’s real playback time. Use them in your own UI. Hidden, stopped or invalid subtitles return empty text.

MWMediaSession.GetSubtitleText
Get current subtitle lines
Get current subtitle lines
Track count

The number of tracks in this playlist.

MWMediaSession.GetTrackCount
Track count
Track count
Playlist track index

Returns the selected row from zero, or -1 for a single source.

MWMediaSession.GetTrackIndex
Playlist track index
Playlist track index
Track name

The name of a playlist row. Use -1 for the current track.

MWMediaSession.GetTrackTitle
Track name
Track name
Get volume

Returns this player's loudness from 0 to 1.

MWMediaSession.GetVolume
Get volume
Get volume
Reopen source

Reopens the selected source after closing it or after an error.

MWMediaSession.Open
Reopen source
Reopen source
Open media

Opens a saved media asset and connects its sound to this game world.

MWMediaSession.OpenMedia
Open media
Open media
Open playlist

Starts a saved playlist. Replace any missing tracks before playing.

MWMediaSession.OpenPlaylist
Open playlist
Open playlist
Pause

Pauses playback and keeps its position.

MWMediaSession.Pause
Pause
Pause
Play

Starts or resumes the current track.

MWMediaSession.Play
Play
Play
Reset equalizer

Returns all six gains to zero without restarting the track or changing its volume.

MWMediaSession.ResetEqualizer
Reset equalizer
Reset equalizer
Seek

Moves to a time in seconds. Returns false when the source cannot seek.

MWMediaSession.Seek
Seek
Seek
Play playlist row

Plays the chosen playlist row. The first row is zero.

MWMediaSession.SelectTrack
Play playlist row
Play playlist row
Set equalizer

Sets 60, 150, 400, 1000, 2500 and 8000 Hz from -12 to +12 dB. Missing band values become zero.

MWMediaSession.SetEqualizer
Set equalizer
Set equalizer
Set one equalizer band

Changes one gain from -12 to +12 dB. Band zero is 60 Hz, then 150, 400, 1000, 2500 and 8000 Hz. Other bands stay as they are. Returns false for an invalid band or value.

MWMediaSession.SetEqualizerBand
Set one equalizer band
Set one equalizer band
Set repeat

Repeats the current source at its end. Playlists have their own repeat setting.

MWMediaSession.SetLooping
Set repeat
Set repeat
Set playlist repeat

Starts a new pass after the last track. Turn off to stop when this pass ends.

MWMediaSession.SetPlaylistRepeat
Set playlist repeat
Set playlist repeat
Set shuffled order

Changes the order of upcoming tracks. Each track plays once per pass, and the selected track starts first. Previous returns through the tracks you have heard.

MWMediaSession.SetPlaylistShuffle
Set shuffled order
Set shuffled order
Set subtitle language

Choose a language found in this file. The default uses the language saved in the source.

MWMediaSession.SetSubtitleLanguage
Set subtitle language
Set subtitle language
Set subtitle visibility

Shows or hides captions in views sharing this session. Video, sound and position keep playing as before.

MWMediaSession.SetSubtitlesEnabled
Set subtitle visibility
Set subtitle visibility
Set subtitle track

Choose imported subtitles from Content. Players can share this file and keep their own appearance.

MWMediaSession.SetSubtitleTrack
Set subtitle track
Set subtitle track
Set volume

Sets this player's volume from 0 for silent to 1 for full volume.

MWMediaSession.SetVolume
Set volume
Set volume
Stop

Stops playback and returns to the beginning. The source stays selected.

MWMediaSession.StopPlayback
Stop
Stop
Play or pause

Pauses a playing track or resumes a paused track.

MWMediaSession.TogglePlayback
Play or pause
Play or pause
MWSubtitleAsset · 5
Get saved subtitle language

Returns the subtitle language used by default.

MWSubtitleAsset.GetDefaultLanguage
Get saved subtitle language
Get saved subtitle language
Get subtitle languages

Lists the subtitle languages in this asset.

MWSubtitleAsset.GetLanguages
Get subtitle languages
Get subtitle languages
Get subtitle lines at time

Returns the lines at the given time, with the saved offset and language.

MWSubtitleAsset.GetTextAtTime
Get subtitle lines at time
Get subtitle lines at time
Read subtitle file

Imports text and timing. Set the font and appearance here. ASS drawings, animation and karaoke need an ordinary timed-text export first.

MWSubtitleAsset.ImportFile
Read subtitle file
Read subtitle file
Check subtitles and font

Checks timing, appearance, language and letters. If something cannot be used, returns false and explains why.

MWSubtitleAsset.Validate
Check subtitles and font
Check subtitles and font
MWSubtitleFontAsset · 1
Check font letters

Checks every letter against this font. Returns false and names the first missing character; it does not substitute another font.

MWSubtitleFontAsset.SupportsText
Check font letters
Check font letters
MWVideoTexture · 3
Apply video to material

Connects this live texture to a texture parameter in a material.

MWVideoTexture.ApplyToMaterial
Apply video to material
Apply video to material
Close video texture

Stops the video and releases its playback resources.

MWVideoTexture.CloseVideo
Close video texture
Close video texture
Start video texture

Starts live video directly in this texture.

MWVideoTexture.Start
Start video texture
Start video texture
MWMediaControlsWidget · 5
Bind Player Id

Connects only to the player with this ID in this world. An unknown ID disconnects the panel and returns false.

MWMediaControlsWidget.BindPlayerId
Bind Player Id
Bind Player Id
Set Button Styles

Replaces the play and secondary button artwork for this panel only. Choose a theme first.

MWMediaControlsWidget.SetButtonStyles
Set Button Styles
Set Button Styles
Set Preset

Changes how many controls this panel shows without restarting playback.

MWMediaControlsWidget.SetPreset
Set Preset
Set Preset
Set Style

Changes this panel's theme without changing another panel or restarting playback.

MWMediaControlsWidget.SetStyle
Set Style
Set Style
Use Session

Connects this panel to an existing player's picture and sound. It does not open another player.

MWMediaControlsWidget.UseSession
Use Session
Use Session
MWPlayerInteractionComponent · 11
Begin Interaction

Enters control mode if the character is within range.

MWPlayerInteractionComponent.BeginInteraction
Begin Interaction
Begin Interaction
Can Control

Whether this input controller can currently operate the selected player.

MWPlayerInteractionComponent.CanControl
Can Control
Can Control
End Interaction

Leaves control mode and cancels held buttons or an unfinished seek.

MWPlayerInteractionComponent.EndInteraction
End Interaction
End Interaction
Get Player Id

The ID of the one player selected by this input controller.

MWPlayerInteractionComponent.GetPlayerId
Get Player Id
Get Player Id
Is in Range

Whether the character is within the configured distance of the selected player.

MWPlayerInteractionComponent.IsInRange
Is in Range
Is in Range
Press Pointer

Presses the selected player's button at the current pointer position, within the allowed distance.

MWPlayerInteractionComponent.PressPointer
Press Pointer
Press Pointer
Release Pointer

Releases a held player button or finishes a slider drag. Leaving the interaction zone cancels the action.

MWPlayerInteractionComponent.ReleasePointer
Release Pointer
Release Pointer
Send Command

Sends a playback command to this player only, while the character is in range and control mode is active.

MWPlayerInteractionComponent.SendCommand
Send Command
Send Command
Send Control Key

Sends a navigation or activation key to the selected player's on-screen controls.

MWPlayerInteractionComponent.SendControlKey
Send Control Key
Send Control Key
Update Pointer Ray

Traces a world ray to the selected player plane. Other blocking objects stop the ray.

MWPlayerInteractionComponent.UpdatePointerRay
Update Pointer Ray
Update Pointer Ray
Update Pointer UV

Moves over a player displayed in your own material. Supply its actual UV coordinates; distance is still checked.

MWPlayerInteractionComponent.UpdatePointerUV
Update Pointer UV
Update Pointer UV
MWPlayerInteractionLibrary · 1
Configure Media Work Player Controls

Selects one player for this controller, chooses cursor or buttons, and sets the required interaction distance. Calling it again changes the selected player.

MWPlayerInteractionLibrary.ConfigurePlayerControls
Configure Media Work Player Controls
Configure Media Work Player Controls
MWPlayerOutput · 8
Close

Closes this output and releases its screen, plane, texture and playback session.

MWPlayerOutput.Close
Close
Close
Get Output Texture

Returns the complete live player texture for texture and plane outputs.

MWPlayerOutput.GetOutputTexture
Get Output Texture
Get Output Texture
Get Plane

Returns the plane created for a saved plane output.

MWPlayerOutput.GetPlane
Get Plane
Get Plane
Get Player Id

Returns the ID used to control only this player.

MWPlayerOutput.GetPlayerId
Get Player Id
Get Player Id
Get Screen Player

Returns the screen widget when the saved output is the game screen.

MWPlayerOutput.GetScreenPlayer
Get Screen Player
Get Screen Player
Get Session

Returns this output's playback session, shared by its picture, sound and controls.

MWPlayerOutput.GetSession
Get Session
Get Session
Get Status

Shows opening progress or the reason why this output could not play.

MWPlayerOutput.GetStatus
Get Status
Get Status
Get Surface

Returns the surface component used to send pointer and key input to a player texture or plane.

MWPlayerOutput.GetSurface
Get Surface
Get Surface
MWPlayerOutputLibrary · 1
Open Saved Player

Opens the saved player on the game screen, on a plane or as a complete texture, according to its output setting. Keep the returned object to control and close this player.

MWPlayerOutputLibrary.OpenSavedPlayer
Open Saved Player
Open Saved Player
MWPlayerPlane · 5
Open Player

Opens a saved player on this plane with its picture, frame, buttons and sound.

MWPlayerPlane.OpenPlayer
Open Player
Open Player
Player UVTo World

Converts texture UV coordinates into a world point on this plane.

MWPlayerPlane.PlayerUVToWorld
Player UVTo World
Player UVTo World
Ray to Player UV

Finds where a ray meets this plane, including beyond its edges for a held slider.

MWPlayerPlane.RayToPlayerUV
Ray to Player UV
Ray to Player UV
Set Plane Width

Changes plane width while preserving the displayed player's proportions.

MWPlayerPlane.SetPlaneWidth
Set Plane Width
Set Plane Width
World to Player UV

Converts a point on this plane to texture UV coordinates. Points beyond its edges also return their coordinates.

MWPlayerPlane.WorldToPlayerUV
World to Player UV
World to Player UV
MWPlayerRenderTexture · 1
Apply to Material

Connects the complete player picture, frame and buttons to a material texture parameter.

MWPlayerRenderTexture.ApplyToMaterial
Apply to Material
Apply to Material
MWPlayerSurfaceComponent · 20
Bind Player Id

Connects to this player's ID in the same world. An unknown ID disconnects this surface.

MWPlayerSurfaceComponent.BindPlayerId
Bind Player Id
Bind Player Id
Cancel Pointer

Cancels a held button or an unfinished seek without applying it. Use this when the pointer loses control.

MWPlayerSurfaceComponent.CancelPointer
Cancel Pointer
Cancel Pointer
Close

Stops drawing and releases the surface. A session opened by this surface is also closed.

MWPlayerSurfaceComponent.Close
Close
Close
Get Output Size

The actual width and height of the complete player texture.

MWPlayerSurfaceComponent.GetOutputSize
Get Output Size
Get Output Size
Get Player Id

The ID of the player used by this surface and its buttons.

MWPlayerSurfaceComponent.GetPlayerId
Get Player Id
Get Player Id
Move Pointer

Moves the pointer over the texture. UV starts at 0,0 in the top-left and ends at 1,1 in the bottom-right.

MWPlayerSurfaceComponent.MovePointer
Move Pointer
Move Pointer
Open Player

Opens a saved player and draws its video, frame and controls into one live texture.

MWPlayerSurfaceComponent.OpenPlayer
Open Player
Open Player
Pointer Down

Presses the primary button at these texture coordinates. Pair it with Pointer Up, including after a drag.

MWPlayerSurfaceComponent.PointerDown
Pointer Down
Pointer Down
Pointer Up

Releases the primary button. A slider drag may finish outside the texture; a button released outside is cancelled.

MWPlayerSurfaceComponent.PointerUp
Pointer Up
Pointer Up
Redraw

Draws a new player frame now. Normally the component updates it automatically.

MWPlayerSurfaceComponent.Redraw
Redraw
Redraw
Send Control Key

Sends a keyboard or gamepad key to this player's controls only.

MWPlayerSurfaceComponent.SendControlKey
Send Control Key
Send Control Key
Set High Precision Output

Chooses smoother 16-bit output or smaller 8-bit output without restarting the video.

MWPlayerSurfaceComponent.SetHighPrecisionOutput
Set High Precision Output
Set High Precision Output
Set Output Quality

Sets the longest texture side in pixels and the redraw rate. Zero frames per second updates every game frame.

MWPlayerSurfaceComponent.SetOutputQuality
Set Output Quality
Set Output Quality
Set Player Title

Sets optional text above this player's video. Empty text removes the heading and its space.

MWPlayerSurfaceComponent.SetPlayerTitle
Set Player Title
Set Player Title
Set Show Controls

Shows or hides the controls in this texture without changing playback.

MWPlayerSurfaceComponent.SetShowControls
Set Show Controls
Set Show Controls
Set Show Subtitles

Shows or hides subtitles in the player texture without changing playback.

MWPlayerSurfaceComponent.SetShowSubtitles
Set Show Subtitles
Set Show Subtitles
Set Style

Changes this surface's frame and buttons without restarting the video.

MWPlayerSurfaceComponent.SetStyle
Set Style
Set Style
Set Video Aspect Ratio

Sets a picture width divided by height. Zero restores automatic video proportions.

MWPlayerSurfaceComponent.SetVideoAspectRatio
Set Video Aspect Ratio
Set Video Aspect Ratio
Set Video Framing

Changes the picture size and position inside this surface. The frame and its buttons stay in place.

MWPlayerSurfaceComponent.SetVideoFraming
Set Video Framing
Set Video Framing
Use Session

Draws and controls an existing session. Closing this surface will leave that session running.

MWPlayerSurfaceComponent.UseSession
Use Session
Use Session
MWPlayerWidget · 9
Close Player

Closes only the playback session created by this widget.

MWPlayerWidget.ClosePlayer
Close Player
Close Player
Open Media

Opens a media asset and connects its sound to this widget's game world.

MWPlayerWidget.OpenMedia
Open Media
Open Media
Open Playlist

Opens an audio playlist with its saved title, list and theme settings.

MWPlayerWidget.OpenPlaylist
Open Playlist
Open Playlist
Set Audio Style

Changes the audio theme without restarting playback or changing the video theme.

MWPlayerWidget.SetAudioStyle
Set Audio Style
Set Audio Style
Set Display Title

Sets optional text above the video. Empty text removes the heading and its space.

MWPlayerWidget.SetDisplayTitle
Set Display Title
Set Display Title
Set Player Style

Changes the video theme without restarting playback or changing the audio theme.

MWPlayerWidget.SetPlayerStyle
Set Player Style
Set Player Style
Set Show Subtitles

Shows or hides subtitles in this widget immediately, without changing other views of the same session.

MWPlayerWidget.SetShowSubtitles
Set Show Subtitles
Set Show Subtitles
Set Video Framing

Changes the picture inside this frame without moving the buttons or restarting playback.

MWPlayerWidget.SetVideoFraming
Set Video Framing
Set Video Framing
Use Session

Connects an existing session. Closing the widget will not close a session owned elsewhere.

MWPlayerWidget.UseSession
Use Session
Use Session