本文小编为大家详细介绍“vue3怎么使用Facebook嵌入式视频播放器API”,内容详细,步骤清晰,细节处理妥当,希望这篇“vue3怎么使用Facebook嵌入式视频播放器API”文章能帮助大家解决疑惑,下面跟着小编的思路慢慢深入,一起来学习新知识吧。
正文
Facebook 嵌入式视频播放器 API是 JavaScript 版 Facebook SDK 提供的客户端功能。可以在自己网站上播放Facebook视频。
开始使用
先引入 Facebook SDK
<script async defer src="https://connect.facebook.net/en_US/sdk.js"></script>
封装成组件FacebookPlayer
<script setup> import { onMounted, onBeforeUnmount } from "vue"; const props = defineProps({ id: { type: String, default: "" }, src: { type: String, required: true }, autoplay: { type: Boolean, default: false } }); const emit = defineEmits(["onEnded", "onPlay", "onPause"]); onMounted(() => { fbAsyncInit(); loadPlayer(); }); onBeforeUnmount(() => { removePlay(); removePaused(); removeEnded(); player = null; }); // Load Facebook SDK for JavaScript const fbAsyncInit = () => { try { window.FB.init({ autoLogAppEvents: true, xfbml: true, version: "v3.2" }); } catch (error) { console.error("FB.init Error", error); } }; // Get Embedded Video Player API Instance let player = null; const loadPlayer = () => { try { window.FB.Event.subscribe("xfbml.ready", (msg) => { if (msg.type === "video" && msg.id === `fb-${props.id}`) { if (!player) player = msg.instance; onPlay(msg.instance); onPaused(msg.instance); onEnded(msg.instance); } }); } catch (error) { console.error("FB.Event Error", error); } }; // 播放器方法 const play = () => player && player.play(); const pause = () => player && player.pause(); // 播放器事件 let playListener; const onPlay = (instance) => { playListener = instance.subscribe("startedPlaying", () => emit("onPlay")); }; const removePlay = () => { try { if (playListener) playListener.release("startedPlaying"); } catch (error) {} }; let pausedListener; const onPaused = (instance) => { pausedListener = instance.subscribe("paused", () => emit("onPause")); }; const removePaused = () => { try { if (pausedListener) pausedListener.release("paused"); } catch (error) {} }; let endedListener; const onEnded = (instance) => { endedListener = instance.subscribe("finishedPlaying", () => emit("onEnded")); }; const removeEnded = () => { try { if (endedListener) endedListener.release("finishedPlaying"); } catch (error) {} }; </script> <template> <div :id="'fb-' + id" class="fb-video" :data-href="https://www.maopiaopiao.com">
使用方式
<facebook-player id="10153231379946729" src="https://www.facebook.com/facebook/videos/10153231379946729/"></facebook-player>
注意事项
class="fb-video" 该类名不能去掉。
如果在一个页面上使用了多个播放器,一定要传唯一id,以此识别播放器。
属性
设置 | 描述 | 默认值 |
---|---|---|
data-href | 视频的绝对网址。 | n/a |
data-allowfullscreen | 允许视频在全屏模式下播放。可以是 false 或 true。 | false |
data-autoplay | 页面加载时自动开始播放视频。视频将无声(静音)播放。用户可以通过视频播放器控制选项打开声音。此设置不适用于移动设备。可以是 false 或 true。 | false |
data-lazy | true 表示您可通过设置 loading="lazy" iframe 属性来使用浏览器的延迟加载机制。其效果是,如果插件不在视区附近,则浏览器不会显示插件,且您可能始终无法看到该插件。可以是 true 或 false(默认)的其中一个。 | false |
data-width | 视频容器的宽度。最小值为 220px。 | auto |
data-show-text | 如果与视频关联的 Facebook 帖子中有任何文本,则设置为 true 以添加该文本。仅适用于桌面端网站。 | false |
data-show-captions | 设置为 true 即可默认显示字幕(如适用)。字幕仅适用于桌面设备。 | false |
方法
函数 | 说明 | 参数(类型) |
---|---|---|
play() | 播放视频。 | |
pause() | 暂停视频。 | |
seek(seconds) | 寻找指定位置。 | seconds (number) |
mute() | 视频设为静音。 | |
unmute() | 取消视频静音。 | |
isMuted() | 视频设为静音时为 true,反之则为 false。 | |
setVolume(volume) | 将音量设置为指定数字(float,范围从 0 到 1)。 | volume (float) |
getVolume() | 返回视频的当前音量(float,范围从 0 到 1)。 | |
getCurrentPosition() | 返回当前的视频时间位置,精确到秒。 | |
getDuration() | 返回视频时长,精确到秒。 | |
subscribe(event, eventCallback) | 为指定事件添加侦听函数。关于事件的详细信息,请参阅事件部分。返回一个口令,其中包含 release 方法,调用此方法会再次从事件中移除侦听程序。 | event (string)、eventCallback (function) |
事件
事件 | 描述 |
---|---|
startedPlaying | 视频开始播放时触发。 |
paused | 视频暂停时触发。 |
finishedPlaying | 视频播放完时触发。 |
startedBuffering | 视频开始缓冲时触发。 |
finishedBuffering | 视频从缓冲恢复时触发。 |
error | 视频发生错误时触发。 |