Fetches a specified video from the Yahoo! Video site and opens it in a manner appropriate for the client device. Usually, this means transferring control to an external application (such as QuickTime).
For information about uploading videos to Yahoo!'s public site, see http://video.yahoo.com/upload.
Some devices do not support video replay. Before sending a page that uses a play-video action, check the page request from the Yahoo! server; the X-Client-Accept header should include video/*.
If the server cannot open the requested video, it may return one of the following standard HTTP error codes:
| Error Code | Meaning | Status | Notes |
|---|---|---|---|
| 400 | Bad Request | Permanent | Usually indicates a missing parameter or malformed URL. |
| 403 | Forbidden | Permanent | Access to the source file is restricted. |
| 404 | Not Found | Permanent | The source file could not be found. |
| 408 | Request Timeout | Temporary | The server may be busy; try again. |
| 413 | Entity Request Too Large | Permanent | The video is too large to transcode. |
| 415 | Unsupported Media Type | Permanent | The source file could not be encoded for the target handset; video support is unavailable. |
| 503 | Service Unavailable | Temporary | The transcoding server may be down; try again. |
Attributes:
The event attribute specifies the event that triggers the action; resource is the URI of the video on the Yahoo! Video site.
Normally, the server sends videos at a bitrate and resolution appropriate for the device and network. You can suggest a higher or lower resolution by setting the bitrate attribute; available values are "low", "medium", and "high" (which typically resolve to 80, 128, and 220 kilobits per second). However, the server is not guaranteed to adhere to the specified bitrate, especially if it is set to a higher value than would otherwise be used. Specify bitrate="low" in situations where it is important for the video to load quickly or you want to ensure the highest probability of success.
Contents:
Examples:
■ Availability:
| Blueprint Version | Support | Notes |
|---|---|---|
| 1.0 | none | invalid |
| 1.1 | full |