This repository has been archived on 2023-06-18. You can view files and clone it, but cannot push or open issues or pull requests.
ima02/resources/defects4j-checkout-closure-1f/contrib/externs/youtubeplayer.js
github-classroom[bot] e42e547e48
Initial commit
2023-04-25 11:33:41 +00:00

373 lines
11 KiB
JavaScript

/*
* Copyright 2012 YouTube LLC
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
/**
* Public API calls.
* @link http://code.google.com/apis/youtube/js_api_reference.html
* @externs
*/
/**
* @constructor
* @extends {HTMLObjectElement}
*/
function YouTubePlayer() {}
/**
* Plays the currently cued/loaded video.
*
*/
YouTubePlayer.prototype.playVideo = function() {};
/**
* Pauses the currently playing video.
*/
YouTubePlayer.prototype.pauseVideo = function() {};
/**
* Stops the current video. This function also closes the NetStream object and cancels the loading of the video.
*/
YouTubePlayer.prototype.stopVideo = function() {};
/**
* Clears the video display. This function is useful if you want to clear the video remnant after calling stopVideo().
*/
YouTubePlayer.prototype.clearVideo = function() {};
/**
* @return {number} The number of bytes loaded for the current video.
*/
YouTubePlayer.prototype.getVideoBytesLoaded = function() {};
/**
* @return {number} The size in bytes of the currently loaded/playing video.
*/
YouTubePlayer.prototype.getVideoBytesTotal = function() {};
/**
* @return {number} The number of bytes the video file started loading from.
*/
YouTubePlayer.prototype.getVideoStartBytes = function() {};
/**
* @return {Array} The current playlist as an array of video IDs.
*/
YouTubePlayer.prototype.getPlaylist = function() {};
/**
* @return {number} The current index in the playlist or -1 when the player has
* no playlist.
*/
YouTubePlayer.prototype.getPlaylistIndex = function() {};
/**
* Calls an option method on the module
* @param {string} moduleId The module descriptor id.
* @param {string} option The option to call on the module.
* @param {*} object Arbitrary data to be sent to the module.
* @return {Object} Returns null if module or option doesn't exist.
*/
YouTubePlayer.prototype.setOption = function(moduleId, option, object) {};
/**
* Calls an option method on the module
* @param {string} moduleId The module descriptor id.
* @param {string} option The option to call on the module.
* @param {*} object Arbitrary data to be sent to the module.
* @return {Object} Returns null if module or option doesn't exist.
*/
YouTubePlayer.prototype.getOption = function(moduleId, option, object) {};
/**
* @return {?string} The current playlist's list id if there is a playlist and
* that playlist was loaded from a list id, otherwise returns null.
*/
YouTubePlayer.prototype.getPlaylistId = function() {};
/**
* Mutes the player.
*/
YouTubePlayer.prototype.mute = function() {};
/**
* Unmutes the player.
*/
YouTubePlayer.prototype.unMute = function() {};
/**
* @return {boolean} true if the player is muted, false if not.
*/
YouTubePlayer.prototype.isMuted = function() {};
/**
* @param {number} volume The volume, an integer between 0 and 100.
*/
YouTubePlayer.prototype.setVolume = function(volume) {};
/**
* @return {number} The player's current volume, an integer between 0 and 100.
*/
YouTubePlayer.prototype.getVolume = function() {};
/**
* Seeks to the specified time of the video in seconds.
* @param {number} seconds The offset to seek to.
* @param {boolean=} opt_allowSeekAhead If true the player will make a new
* server request if seconds is beyond the currently loaded video data.
*/
YouTubePlayer.prototype.seekTo = function(seconds, opt_allowSeekAhead) {};
/**
* @return {number} The state of the player. Possible values are unstarted
* (-1), ended (0), playing (1), paused (2), buffering (3), video cued (5).
*/
YouTubePlayer.prototype.getPlayerState = function() {};
/**
* Returns the current playback rate setting of the player.
* @return {number} The current playback rate setting of the player.
*/
YouTubePlayer.prototype.getPlaybackRate = function() {};
/**
* Sets the playback rate for the player based on the rate suggested by the
* user. The actually applied rate is the closest supported rate that lies
* between 1.0 and the suggested rate (inclusive). 1.0 will always be one
* of the supported playback rates.
* @param {number} suggestedRate The playback rate suggested by the user.
*/
YouTubePlayer.prototype.setPlaybackRate = function(suggestedRate) {};
/**
* Gets an array of playback rates supported by the video player, sorted in
* ascending order. This array is guaranteed to have the entry 1.0.
* @return {Array.<number>} Playback rates supported by the player.
*/
YouTubePlayer.prototype.getAvailablePlaybackRates = function() {};
/**
* @return {string} The current quality the player has loaded or is playing.
*/
YouTubePlayer.prototype.getPlaybackQuality = function() {};
/**
* Sets the playback quality in the video player. If the quality is not the
* current playing quality, the player will load the new quality.
* @param {string} quality The video quality the player should load and play.
*/
YouTubePlayer.prototype.setPlaybackQuality = function(quality) {};
/**
* @return {Array} Array of available quality levels in order of decreasing quality.
*/
YouTubePlayer.prototype.getAvailableQualityLevels = function() {};
/**
* @return {number} The elapsed time in seconds since the video started playing.
*/
YouTubePlayer.prototype.getCurrentTime = function() {};
/**
* @return {number} The duration in seconds of the currently playing video.
*/
YouTubePlayer.prototype.getDuration = function() {};
/**
* @param {string} event The event to listen for.
* @param {string|EventListener|Function} listener The function to call
* when the event occurs.
*/
YouTubePlayer.prototype.addEventListener = function(event, listener) {};
/**
* @return {string} The YouTube.com URL for the currently loaded/playing video.
*/
YouTubePlayer.prototype.getVideoUrl = function() {};
/**
* @return {string} The embed code for the currently loaded/playing video.
*/
YouTubePlayer.prototype.getVideoEmbedCode = function() {};
/**
* Loads the specified video's thumbnail and prepares the player to play the
* video.
* @param {Object|string} videoIdOrObject YouTube Video ID or object.
* @param {number} opt_startSeconds The video will start from the keyframe
* nearest this time.
*/
YouTubePlayer.prototype.cueVideoById =
function(videoIdOrObject, opt_startSeconds) {};
/**
* Loads and plays the specified video.
* @param {Object|string} videoIdOrObject YouTube Video ID or object.
* @param {number} opt_startSeconds The video will start from the keyframe
* nearest this time.
*/
YouTubePlayer.prototype.loadVideoById =
function(videoIdOrObject, opt_startSeconds) {};
/**
* Loads the specified video's thumbnail and prepares the player to play the video.
* @param {string} mediaContentUrl YouTube player URL in the format
* http://www.youtube.com/v/VIDEO_ID.
* @param {number} opt_startSeconds The video will start from the keyframe nearest this time.
*/
YouTubePlayer.prototype.cueVideoByUrl = function(mediaContentUrl, opt_startSeconds) {};
/**
* Loads and plays the specified video.
* @param {string} mediaContentUrl YouTube player URL in the format
* http://www.youtube.com/v/VIDEO_ID.
* @param {number} opt_startSeconds The video will start from the keyframe nearest this time.
*/
YouTubePlayer.prototype.loadVideoByUrl = function(mediaContentUrl, opt_startSeconds) {};
/**
* Loads and plays a specified video in a playlist.
* @param {string|Array|Object} playlistOrObject An object containing all of the
* parameters. Otherwise, a string that is a playlist id (without
* the PL list prefix) or an array of video ids.
* @param {number=} opt_index The index to begin playback at.
* @param {number=} opt_startSeconds Float/integer that specifies the time
* from which the video should start playing.
* @param {string=} opt_suggestedQuality The suggested playback quality for
* the video.
*/
YouTubePlayer.prototype.cuePlaylist = function(playlistOrObject,
opt_index, opt_startSeconds, opt_suggestedQuality) {};
/**
* Loads and cues a specified video in a playlist.
* @param {string|Array|Object} playlistOrObject An object containing all of the
* parameters. Otherwise, a string that is a playlist id (without
* the PL list prefix) or an array of video ids.
* @param {number=} opt_index The index to begin playback at.
* @param {number=} opt_startSeconds Float/integer that specifies the time
* from which the video should start playing.
* @param {string=} opt_suggestedQuality The suggested playback quality for
* the video.
*/
YouTubePlayer.prototype.loadPlaylist = function(playlistOrObject,
opt_index, opt_startSeconds, opt_suggestedQuality) {};
/**
* Plays the next video in the playlist. At the end of the playlist, this will
* go to the first video when loop is enabled, otherwise it will be a noop.
*/
YouTubePlayer.prototype.nextVideo = function() {};
/**
* Plays the previous video in the playlist. At the front of the playlist, this
* will go to the last video when loop is enabled, otherwise it will be a noop.
*/
YouTubePlayer.prototype.previousVideo = function() {};
/**
* Plays a specific video in the playlist. If the provided index is not in the
* playlist, this will be a noop.
* @param {number} index The index of the video in the playlist to play.
*/
YouTubePlayer.prototype.playVideoAt = function(index) {};
/**
* Shuffle the playlist when setting shuffle to true, or return the playlist to
* the original order when setting to false.
* @param {boolean} shuffle If the playlist should shuffle.
*/
YouTubePlayer.prototype.setShuffle = function(shuffle) {};
/**
* @param {boolean} loop If the playlist should loop.
*/
YouTubePlayer.prototype.setLoop = function(loop) {};
/**
* Sets the size in pixels of the player. You should not have to use this
* method in JavaScript as the player will automatically resize when the
* containing elements in the embed code have their height and width
* properties modified.
* @param {number} width Player width.
* @param {number} height Player height.
*/
YouTubePlayer.prototype.setSize = function(width, height) {};
/**
* Destroys the player reference.
*/
YouTubePlayer.prototype.destroy = function() {};
/**
* On player ready callback.
*
* @param {string} playerapiid String identifier for a player.
*/
function onYouTubePlayerReady(playerapiid) {}
/**
* On player ready callback.
*
* @param {string} playerapiid String identifier for a player.
*/
Window.prototype.onYouTubePlayerReady = function(playerapiid) {};