Displaying Application Status Using Icons

16-18 Web User Interface Developers Guide for Oracle Application Development Framework For example, you can have the player display all controls available, the most commonly used controls, or no controls. As an example, Example 16–7 uses the all setting for a media component. Example 16–7 Controls for a Media Player af:media source=imagesmyvideo.wmv controls=all Figure 16–12 shows how the player is displayed to the user. Figure 16–12 Media Player with All Controls Following values are valid: – All : Show all available controls for playing media on the media player. Using this setting can cause a large amount of additional space to be required, depending on the media player used. – Minimal : Show a minimal set of controls for playing media on the media player. This value gives users control over the most important media playing con- trols, while occupying the least amount of additional space on the user agent. – None : Do not show any controls for the media player and do not allow control access through other means, such as context menus. You would typically use this setting only for kiosk-type applications, where no user control over the playing of the media is allowed. This set- ting is typically used in conjunction with settings that automatically start the playback, and to play back continuously. – NoneVisible : Do not show any controls for the media player, but allow control access through alternate means, such as context menus. You would typically use this value only in applications where user con- trol over the playing of the media is allowed, but not encouraged. As with the none setting, this setting is typically used in conjunction with settings that automatically start the playback, and to play back continuously. – Typical : Show the typical set of controls for playing media on the media player. This value, the default, gives users control over the most common media playing controls, without occupying an inordinate amount of extra space on the user agent. ■ Width and Height: Define the size in pixels of the complete display, including the whole player area, which includes the media content area. Using Output Components 16-19 ■ InnerWidth and InnerHeight: Define the size in pixels of only the media content area. This is the preferred scheme, because you control the amount of space allocated to the player area for your clip.

5. Expand the Behavior section and set Autostart. By default, playback of a clip will

not start until the user starts it using the displayed controls. You can specify that playback is to start as soon as the clip is loaded by setting the autostart attribute to true. Set PlayCount to the number of times you want the media to play. Once started, by default, the clip with play through once only. If the users have controls available, they can replay the clip. However, you can specify that the clip is to play back a fixed number of times, or loop continuously, by setting a value for the playCount attribute. Setting the playCount attribute to 0 replays the clip continuously. Setting the attribute to some other number plays the clip the specified number of times. Example 16–8 shows an af:media component in the source of a page. The component will play a video clip starting as soon as it is loaded and will continue to play the clip until stopped by the user. The player will display all the available controls. Example 16–8 Media Component to Play a Video Clip Continuously af:media source=componentsimagesseattle.wmv playCount=0 autostart=true controls=all innerHeight=112 innerWidth=260 shortDesc=My Video Clip standbyText=My video clip is loading Tip: Using the width and height attributes can lead to unexpected results because it is difficult to define a suitable width and height to use across different players and different player control configurations. Instead of defining the size of the complete display, you can instead define just the size of the media content area using the innerWidth and innerHeight attributes. Tip: If you do not specify a size for the media control, a default inner size, determined by the content type of the media resource, is used. While this works well for audio content, it can cause video content to be clipped or to occupy too much space. If you specify dimensions from both schemes, such as a height and an innerHeight, the overall size defined by the height attribute is used. Similarly, if you specify both a width and an innerWidth, the width attribute is used.