小提琴链接:源代码-预览-小版本
更新:这个小功能只会在一个方向上执行代码。如果你想完全支持(如事件监听器/吸气),看看在侦听YouTube事件中的jQuery
作为深入代码分析的结果,我创建了一个函数:function callPlayer
请求对任何带框的 YouTube 视频进行函数调用。请参阅YouTube Api 参考以获取可能的函数调用的完整列表。阅读源代码中的注释以获得解释。
2012 年 5 月 17 日,代码大小增加了一倍,以照顾玩家的就绪状态。如果您需要一个不处理播放器就绪状态的紧凑函数,请参阅http://jsfiddle.net/8R5y6/。
/**
* @author Rob W <gwnRob@gmail.com>
* @website https://stackoverflow.com/a/7513356/938089
* @version 20190409
* @description Executes function on a framed YouTube video (see website link)
* For a full list of possible functions, see:
* https://developers.google.com/youtube/js_api_reference
* @param String frame_id The id of (the div containing) the frame
* @param String func Desired function to call, eg. "playVideo"
* (Function) Function to call when the player is ready.
* @param Array args (optional) List of arguments to pass to function func*/
function callPlayer(frame_id, func, args) {
if (window.jQuery && frame_id instanceof jQuery) frame_id = frame_id.get(0).id;
var iframe = document.getElementById(frame_id);
if (iframe && iframe.tagName.toUpperCase() != 'IFRAME') {
iframe = iframe.getElementsByTagName('iframe')[0];
}
// When the player is not ready yet, add the event to a queue
// Each frame_id is associated with an own queue.
// Each queue has three possible states:
// undefined = uninitialised / array = queue / .ready=true = ready
if (!callPlayer.queue) callPlayer.queue = {};
var queue = callPlayer.queue[frame_id],
domReady = document.readyState == 'complete';
if (domReady && !iframe) {
// DOM is ready and iframe does not exist. Log a message
window.console && console.log('callPlayer: Frame not found; id=' + frame_id);
if (queue) clearInterval(queue.poller);
} else if (func === 'listening') {
// Sending the "listener" message to the frame, to request status updates
if (iframe && iframe.contentWindow) {
func = '{"event":"listening","id":' + JSON.stringify(''+frame_id) + '}';
iframe.contentWindow.postMessage(func, '*');
}
} else if ((!queue || !queue.ready) && (
!domReady ||
iframe && !iframe.contentWindow ||
typeof func === 'function')) {
if (!queue) queue = callPlayer.queue[frame_id] = [];
queue.push([func, args]);
if (!('poller' in queue)) {
// keep polling until the document and frame is ready
queue.poller = setInterval(function() {
callPlayer(frame_id, 'listening');
}, 250);
// Add a global "message" event listener, to catch status updates:
messageEvent(1, function runOnceReady(e) {
if (!iframe) {
iframe = document.getElementById(frame_id);
if (!iframe) return;
if (iframe.tagName.toUpperCase() != 'IFRAME') {
iframe = iframe.getElementsByTagName('iframe')[0];
if (!iframe) return;
}
}
if (e.source === iframe.contentWindow) {
// Assume that the player is ready if we receive a
// message from the iframe
clearInterval(queue.poller);
queue.ready = true;
messageEvent(0, runOnceReady);
// .. and release the queue:
while (tmp = queue.shift()) {
callPlayer(frame_id, tmp[0], tmp[1]);
}
}
}, false);
}
} else if (iframe && iframe.contentWindow) {
// When a function is supplied, just call it (like "onYouTubePlayerReady")
if (func.call) return func();
// Frame exists, send message
iframe.contentWindow.postMessage(JSON.stringify({
"event": "command",
"func": func,
"args": args || [],
"id": frame_id
}), "*");
}
/* IE8 does not support addEventListener... */
function messageEvent(add, listener) {
var w3 = add ? window.addEventListener : window.removeEventListener;
w3 ?
w3('message', listener, !1)
:
(add ? window.attachEvent : window.detachEvent)('onmessage', listener);
}
}
用法:
callPlayer("whateverID", function() {
// This function runs once the player is ready ("onYouTubePlayerReady")
callPlayer("whateverID", "playVideo");
});
// When the player is not ready yet, the function will be queued.
// When the iframe cannot be found, a message is logged in the console.
callPlayer("whateverID", "playVideo");
可能的问题(和答案):
问:它不起作用!
答:“不起作用”不是一个明确的描述。您是否收到任何错误消息?请出示相关代码。
问:playVideo
不播放视频。
A : Playback 需要用户交互,并且存在allow="autoplay"
于 iframe 上。请参阅https://developers.google.com/web/updates/2017/09/autoplay-policy-changes和https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide
Q : 我已经嵌入了一个 YouTube 视频,<iframe src="http://www.youtube.com/embed/As2rZGPGKDY" />
但该功能没有执行任何功能!
A : 您必须?enablejsapi=1
在 URL 末尾添加:/embed/vid_id?enablejsapi=1
。
问:我收到错误消息“指定了无效或非法的字符串”。为什么?
A : API 在本地主机 ( file://
)上无法正常运行。在线托管您的(测试)页面,或使用JSFiddle。示例:请参阅此答案顶部的链接。
问:你是怎么知道这个的?
A : 我花了一些时间来手动解释 API 的源代码。我得出结论,我必须使用该postMessage
方法。为了知道要传递哪些参数,我创建了一个拦截消息的 Chrome 扩展程序。可以在此处下载扩展的源代码。
问:支持哪些浏览器?
答:所有支持JSON和postMessage
.
- 浏览器 8+
- Firefox 3.6+(实际上是 3.5,但
document.readyState
在 3.6 中实现)
- 歌剧 10.50+
- 野生动物园 4+
- 铬 3+
相关答案/实现:使用 jQuery
完整 API 支持淡入带框视频:在 jQuery
官方 API 中侦听 Youtube 事件:https : //developers.google.com/youtube/iframe_api_reference
修订记录
- 2012 年 5 月 17 日
实施onYouTubePlayerReady
:callPlayer('frame_id', function() { ... })
。
当播放器尚未准备好时,函数会自动排队。
- 2012 年 7 月 24 日
在支持的浏览器中更新并成功测试(展望未来)。
- 2013 年 10 月 10 日当函数作为参数传递时,
callPlayer
强制检查准备情况。这是必需的,因为在callPlayer
文档准备好插入 iframe 之后立即调用when ,它无法确定 iframe 是否完全准备好。在 Internet Explorer 和 Firefox 中,这种情况导致过早调用postMessage
,而这被忽略了。
- 2013 年 12 月 12 日,建议
&origin=*
在 URL 中添加。
- 2014 年 3 月 2 日,撤回了删除
&origin=*
URL 的建议。
- 2019 年 4 月 9 日,修复了在页面准备就绪之前加载 YouTube 时导致无限递归的错误。添加有关自动播放的注释。