AVPlayer.AddView
----------------

Creates a player view.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [AVPlayer](component_AVPlayer.md) | [10.2](newinversion102.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ❌ No |

MBS( "AVPlayer.AddView"; AVPlayer; WindowRef; ControlName { ; DX; DY } ) 

**MBS**( **"AVPlayer.AddView";** /\* Creates a player view. \*/  
**$AVPlayer**; /\* The reference number of the player.e.g. $Player \*/   
**$WindowRef**; /\* Window Reference is the unique OS level window ID. You can obtain this by using the [Window.FindByTitle](WindowFindByTitle.md) or [Window.FindByIndex](WindowFindByIndex.md) functions. Pass zero to access the frontmost window.e.g. 0 \*/   
**$ControlName**; /\* The name of the control on your FileMaker form.   
e.g. you can place a rectangle there to define the position.e.g. "mymedia" \*/   
**$DX**; /\* Optional; A delta to move view more to left or right.e.g. 0 \*/   
**$DY**) /\* Optional; A delta to move view more to top or bottom.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| AVPlayer | The reference number of the player. | $Player |  |
| WindowRef | Window Reference is the unique OS level window ID. You can obtain this by using the [Window.FindByTitle](WindowFindByTitle.md) or [Window.FindByIndex](WindowFindByIndex.md) functions. Pass zero to access the frontmost window. | 0 |  |
| ControlName | The name of the control on your FileMaker form.    e.g. you can place a rectangle there to define the position. | "mymedia" |  |
| DX | A delta to move view more to left or right. | 0 | Optional |
| DY | A delta to move view more to top or bottom. | 0 | Optional |

### Result

Returns OK or error.

### Description

Creates a player view.  
We create a new player view and use it for the current player to display video data.  
Use [AVPlayer.Release](AVPlayerRelease.md) later to destroy the player and the view.  
If you use a register (tab controls) on the window, be aware that the text view actually is in front of the register (tab controls). You may hide the text view if another register is visible.  
When creating on a card window, please pass reference to parent window or just 0 for front window. On MacOS you may need to pass delta y value to adjust position.  
  
If you create a control on a new window, you may do window update command in your script first to have FileMaker actually build the window with controls and display it. A short script pause or using [FM.RunScriptLater](FMRunScriptLater.md) with 0.1 delay can help having all controls draw themselves. Then you can use this command to put our control on top. We use GetLayoutObjectAttribute() to query left, top, width and height and this gives empty value if control is not yet here.  
  
Mac 64-bit only.  
### Examples

Add view to show player:

 Set Variable \[ $r ; Value: MBS ( "AVPlayer.AddView"; $$Player ; Get(WindowName); "placeholder") \]   
Set Variable \[ $r ; Value: MBS ( "[AVPlayer.SetControlsStyle](AVPlayerSetControlsStyle.md)"; $$Player ; "Inline" ) \]   
Set Variable \[ $r ; Value: MBS ( "[AVPlayer.SetAutoResizingMask](AVPlayerSetAutoResizingMask.md)"; $$Player ; 4 + 32 ) \]  
### See also

- [AVPlayer.Release](AVPlayerRelease.md)
- [AVPlayer.SetAutoResizingMask](AVPlayerSetAutoResizingMask.md)
- [AVPlayer.SetControlsStyle](AVPlayerSetControlsStyle.md)
- [FM.RunScript](FMRunScript.md)
- [FM.RunScriptLater](FMRunScriptLater.md)
- [Window.FindByIndex](WindowFindByIndex.md)
- [Window.FindByTitle](WindowFindByTitle.md)

### Release notes

- **Version 10.3**
    - Rewrote control placement for MacOS and iOS controls for [AVPlayer.AddView](https://www.mbsplugins.eu/AVPlayerAddView.shtml), [DragDrop.CreateWithControl](https://www.mbsplugins.eu/DragDropCreateWithControl.shtml), [ImageView.CreateWithControl](https://www.mbsplugins.eu/ImageViewCreateWithControl.shtml), [MapView.CreateWithControl](https://www.mbsplugins.eu/MapViewCreateWithControl.shtml), [TextView.CreateWithControl](https://www.mbsplugins.eu/TextViewCreateWithControl.shtml), [WebView.CreateWithControl](https://www.mbsplugins.eu/WebViewCreateWithControl.shtml).
- **Version 10.2**
    - Added view option for AVPlayer with [AVPlayer.AddView](https://www.mbsplugins.eu/AVPlayerAddView.shtml) function and related.

### Example Databases

- [Mac and iOS/AVPlayer](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/AVPlayer.shtml#8ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 10.3pr3](https://www.mbsplugins.de/archive/2020-06-12/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [News about the MBS FileMaker Plugin 10.2](https://www.mbsplugins.de/archive/2020-05-19/News_about_the_MBS_FileMaker_P/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.2pr1](https://www.mbsplugins.de/archive/2020-04-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 12nd March 2020 , last changed 28th April 2024

  
[AVExport.SupportedFileTypes](AVExportSupportedFileTypes.md) - [AVPlayer.CloseView](AVPlayerCloseView.md)

[HTML Version](AVPlayerAddView.shtml)