YouTube PIP Button (Safari Desktop Mode + Auto PIP)

Generate PIP button on YouTube Player Desktop Mode + auto PIP when Safari tab goes background

目前為 2025-11-14 提交的版本,檢視 最新版本

您需要先安裝使用者腳本管理器擴展,如 TampermonkeyGreasemonkeyViolentmonkey 之後才能安裝該腳本。

You will need to install an extension such as Tampermonkey to install this script.

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyViolentmonkey 後才能安裝該腳本。

您需要先安裝使用者腳本管理器擴充功能,如 TampermonkeyUserscripts 後才能安裝該腳本。

你需要先安裝一款使用者腳本管理器擴展,比如 Tampermonkey,才能安裝此腳本

您需要先安裝使用者腳本管理器擴充功能後才能安裝該腳本。

(我已經安裝了使用者腳本管理器,讓我安裝!)

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展,比如 Stylus,才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

(我已經安裝了使用者樣式管理器,讓我安裝!)

// ==UserScript==
// @name         YouTube PIP Button (Safari Desktop Mode + Auto PIP)
// @version      1.1
// @description  Generate PIP button on YouTube Player Desktop Mode + auto PIP when Safari tab goes background
// @match        https://www.youtube.com/*
// @grant        none
// @namespace    colodes
// @license      MIT
// ==/UserScript==

(function() {
    'use strict';

    const controlSelector = '.ytp-left-controls';
    const AUTO_PIP_ON_HIDE = true; // 页面被隐藏(回桌面/切换标签)时自动尝试进入 PIP

    let lastVideo = null;

    function canUsePip(video) {
        if (!video) return false;
        // 老 API:webkitSupportsPresentationMode / webkitSetPresentationMode
        if (typeof video.webkitSetPresentationMode === 'function') {
            if (typeof video.webkitSupportsPresentationMode === 'function') {
                try {
                    if (!video.webkitSupportsPresentationMode('picture-in-picture')) {
                        return false;
                    }
                } catch (_) {}
            }
            return true;
        }
        return false;
    }

    function enterPip(video) {
        if (!canUsePip(video)) return;
        try {
            if (video.webkitPresentationMode !== 'picture-in-picture') {
                video.webkitSetPresentationMode('picture-in-picture');
            }
        } catch (_) {}
    }

    function exitPip(video) {
        if (!canUsePip(video)) return;
        try {
            if (video.webkitPresentationMode === 'picture-in-picture') {
                video.webkitSetPresentationMode('inline');
            }
        } catch (_) {}
    }

    function togglePip(video) {
        if (!canUsePip(video)) return;
        try {
            if (video.webkitPresentationMode === 'picture-in-picture') {
                video.webkitSetPresentationMode('inline');
            } else {
                video.webkitSetPresentationMode('picture-in-picture');
            }
        } catch (_) {}
    }

    function createPipButton(video) {
        const btn = document.createElement('button');
        const icon = document.createElement('span');
        icon.textContent = '◲';

        Object.assign(btn.style, {
            background: 'rgba(0, 0, 0, 0.3)',
            color: '#fff',
            border: 'none',
            borderRadius: '50%',
            width: '36px',
            height: '36px',
            fontSize: '30px',
            display: 'flex',
            alignItems: 'center',
            justifyContent: 'center',
            margin: '10px',
            userSelect: 'none',
            textShadow: '0 0px 3px rgba(0, 0, 0, 0.5)',
            cursor: 'pointer'
        });
        Object.assign(icon.style, {
            transform: 'translateY(-2px)',
            display: 'inline-block',
        });

        btn.appendChild(icon);
        btn.classList.add('my-pip-btn');
        btn.onclick = e => {
            e.stopPropagation();
            if (!video) return;
            togglePip(video);
        };
        return btn;
    }

    function injectButtons() {
        const video = document.querySelector('video');
        if (!video) return;
        lastVideo = video;

        const roots = [document];
        const host = document.querySelector('ytp-player');
        if (host?.shadowRoot) roots.push(host.shadowRoot);

        roots.forEach(root => {
            root.querySelectorAll(controlSelector).forEach(container => {
                if (!container.querySelector('.my-pip-btn')) {
                    container.appendChild(createPipButton(video));
                }
            });
        });
    }

    // 当页面进入后台 / 被隐藏时,自动尝试进入 PIP
    function handleAutoPip() {
        if (!AUTO_PIP_ON_HIDE) return;

        // 优先用 lastVideo,退而求其次重新 query
        const video = lastVideo || document.querySelector('video');
        if (!video) return;

        // 只对正在播放的视频自动 PIP,避免误触
        if (video.paused || video.ended) return;

        enterPip(video);
    }

    // 1. Safari 切换标签页 / 回桌面时,一般会触发 visibilitychange 为 hidden
    document.addEventListener('visibilitychange', () => {
        if (document.visibilityState === 'hidden') {
            handleAutoPip();
        }
    }, true);

    // 2. 作为补充,一些情况下会触发 pagehide
    window.addEventListener('pagehide', () => {
        handleAutoPip();
    }, true);

    // 观察页面变化,注入按钮
    new MutationObserver(injectButtons).observe(document.body, { childList: true, subtree: true });
    injectButtons();
})();