投稿: ArtPlayer プレーヤーの簡単な使い方

公開日: 2024-08-11 19:40 更新日: 2024-08-11 23:32 688文字 4 min read

ArtPlayer プレイヤーはシンプルなインターフェースで、機能が強力で拡張性が高いです。しかし、私個人としては公式ドキュメントの説明が複雑すぎて、ただ単に簡単に使ってみたくて、それほど多くの機能を使う必要はないと感じました。そのため、コードを少し整理して、よく使う機能をまとめました。

AIモデル Qwen/Qwen3-8B による翻訳。

原文言語:Simplified Chinese、翻訳先言語:japanese、翻訳時間:2026-05-01 15:19

AI 翻訳は参考に限り、内容の完全な正確性を保証できません。原文をご参照ください。

前言

ArtPlayer プレイヤーはインターフェースがシンプルで、機能が強力かつ拡張性に優れています。

ただし、私自身は公式ドキュメントが複雑すぎると思っています。ただ単に簡単に使ってみたくて、そんなに多くの機能を使う必要はありません。

そのため、コードを少し整理して、よく使う機能を一まとめにしました。

実例

コード
var art = new Artplayer({
    container: '.artplayer-app', 
    // container: document.querySelector('.artplayer-app'),
    url: 'https://artplayer.org/assets/sample/video.mp4',
    id: 'your-url-id', // 只用于记忆播放
    poster: 'https://artplayer.org/assets/sample/poster.jpg', //视频的海报,只会出现在播放器初始化且未播放的状态下
    theme: '#23ade5', // 主题色
    volume: 0.7, // 默认音量
    autoplay: false,  // 自动播放
    autoSize: true, // 自动调整播放器尺寸以隐藏黑边
    autoMini: true, // 当播放器滚动到浏览器视口以外时,自动进入 迷你播放 模式
    // 设置面板
    setting: true, // 设置面板
    flip: true, // 显示视频翻转功能
    playbackRate: true, // 显示视频播放速度功能
    aspectRatio: true, // 显示视频长宽比功能

    screenshot: true, // 在底部控制栏里显示 视频截图 功能 提示由于浏览器安全机制,假如视频源地址和网站是跨域的,可能会出现截图失败
    hotkey: true, // 使用快捷键
    pip: true, // 在底部控制栏里显示 画中画 的开关按钮
    pip: true, // 只能让一个播放器播放
    fullscreen: true, // 在底部控制栏里显示播放器 窗口全屏 按钮
    miniProgressBar: true, // 迷你进度条
    playsInline: true, // 移动端 playsInline 模式

    // 设置 预览图
    // 在线生成预览图
    // https://artplayer.org/?libs=./uncompiled/artplayer-tool-thumbnail/index.js&example=thumbnail

    thumbnails: {
        url: 'https://artplayer.org/assets/sample/thumbnails.png',
        number: 60,
        column: 10,
    },
    // 替换默认图标
    icons: {
        loading: '<img src="https://artplayer.org/assets/img/ploading.gif">',
        state: '<img width="150" heigth="150" src="https://artplayer.org/assets/img/state.svg">',
        indicator: '<img width="16" heigth="16" src="https://artplayer.org/assets/img/indicator.svg">',
    },
    lock: true, // 移动端显示一个 锁定按钮 ,用于隐藏底部 控制栏
    fastForward: true, // 移动端添加长按视频快进功能
    autoOrientation: true,  // 是否在移动端的网页全屏时,根据视频尺寸和视口尺寸,旋转播放器
    airplay: true, // 显示 airplay 按钮
});

プレイヤーが表示されない場合は、ブラウザをリロードしてみてください。

本文は以上です。本文がお役に立てた場合は、親切なコメントを残していただけますか?

気に入ったならばコメントを残してくださいね~