# -*- coding: utf-8 -*- ########################################################################## # OpenLP - Open Source Lyrics Projection # # ---------------------------------------------------------------------- # # Copyright (c) 2008-2022 OpenLP Developers # # ---------------------------------------------------------------------- # # This program is free software: you can redistribute it and/or modify # # it under the terms of the GNU General Public License as published by # # the Free Software Foundation, either version 3 of the License, or # # (at your option) any later version. # # # # This program is distributed in the hope that it will be useful, # # but WITHOUT ANY WARRANTY; without even the implied warranty of # # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # # GNU General Public License for more details. # # # # You should have received a copy of the GNU General Public License # # along with this program. If not, see . # ########################################################################## """ The :mod:`~openlp.core.ui.media.vlcplayer` module contains our VLC component wrapper """ import ctypes import logging import os import sys import threading from datetime import datetime from time import sleep from PyQt5 import QtCore, QtWidgets from openlp.core.common import is_linux, is_macosx, is_win from openlp.core.common.i18n import translate from openlp.core.display.screens import ScreenList from openlp.core.lib.ui import critical_error_message_box from openlp.core.ui.media import MediaState, MediaType from openlp.core.ui.media.mediaplayer import MediaPlayer log = logging.getLogger(__name__) # Audio and video extensions copied from 'include/vlc_interface.h' from vlc 2.2.0 source def get_vlc(): """ In order to make this module more testable, we have to wrap the VLC import inside a method. We do this so that we can mock out the VLC module entirely. :return: The "vlc" module, or None """ # Import the VLC module if not already done if 'vlc' not in sys.modules: try: import vlc # noqa module is not used directly, but is used via sys.modules['vlc'] except (ImportError, OSError): return None # Verify that VLC is also loadable is_vlc_available = False try: is_vlc_available = bool(sys.modules['vlc'].get_default_instance()) except Exception: pass if is_vlc_available: return sys.modules['vlc'] return None # On linux we need to initialise X threads, but not when running tests. # This needs to happen on module load and not in get_vlc(), otherwise it can cause crashes on some DE on some setups # (reported on Gnome3, Unity, Cinnamon, all GTK+ based) when using native filedialogs... if is_linux() and 'pytest' not in sys.argv[0] and get_vlc(): try: try: x11 = ctypes.cdll.LoadLibrary('libX11.so.6') except OSError: # If libx11.so.6 was not found, fallback to more generic libx11.so x11 = ctypes.cdll.LoadLibrary('libX11.so') x11.XInitThreads() except Exception: log.exception('Failed to run XInitThreads(), VLC might not work properly!') class VlcPlayer(MediaPlayer): """ A specialised version of the MediaPlayer class, which provides a VLC display. """ def __init__(self, parent): """ Constructor """ super(VlcPlayer, self).__init__(parent, 'vlc') self.original_name = 'VLC' self.display_name = '&VLC' self.parent = parent self.can_folder = True def setup(self, controller, display): """ Set up the media player :param controller: The controller where the media is :param display: The display where the media is. :return: """ vlc = get_vlc() if controller.is_live: controller.vlc_widget = QtWidgets.QFrame() controller.vlc_widget.setWindowFlags(QtCore.Qt.FramelessWindowHint | QtCore.Qt.Tool | QtCore.Qt.WindowStaysOnTopHint) else: controller.vlc_widget = QtWidgets.QFrame(display) controller.vlc_widget.setFrameStyle(QtWidgets.QFrame.NoFrame) # creating a basic vlc instance command_line_options = '--no-video-title-show --input-repeat=99999999 ' if self.settings.value('advanced/hide mouse') and controller.is_live: command_line_options += '--mouse-hide-timeout=0 ' if self.settings.value('media/vlc arguments'): options = command_line_options + ' ' + self.settings.value('media/vlc arguments') controller.vlc_instance = vlc.Instance(options) # if the instance is None, it is likely that the comamndline options were invalid, so try again without if not controller.vlc_instance: controller.vlc_instance = vlc.Instance(command_line_options) if controller.vlc_instance: critical_error_message_box(message=translate('MediaPlugin.VlcPlayer', 'The VLC arguments are invalid.')) else: return else: controller.vlc_instance = vlc.Instance(command_line_options) if not controller.vlc_instance: return log.debug(f"VLC version: {vlc.libvlc_get_version()}") # creating an empty vlc media player controller.vlc_media_player = controller.vlc_instance.media_player_new() controller.vlc_widget.resize(controller.size()) controller.vlc_widget.hide() # The media player has to be 'connected' to the QFrame. # (otherwise a video would be displayed in it's own window) # This is platform specific! # You have to give the id of the QFrame (or similar object) # to vlc, different platforms have different functions for this. win_id = int(controller.vlc_widget.winId()) if is_win(): controller.vlc_media_player.set_hwnd(win_id) elif is_macosx(): # We have to use 'set_nsobject' since Qt5 on OSX uses Cocoa # framework and not the old Carbon. controller.vlc_media_player.set_nsobject(win_id) else: # for Linux/*BSD using the X Server controller.vlc_media_player.set_xwindow(win_id) self.has_own_widget = True def check_available(self): """ Return the availability of VLC """ return get_vlc() is not None def load(self, controller, output_display, file): """ Load a video into VLC :param controller: The controller where the media is :param output_display: The display where the media is :param file: file/stream to be played :return: """ if not controller.vlc_instance: return False vlc = get_vlc() log.debug('load video in VLC Controller') path = None if file and not controller.media_info.media_type == MediaType.Stream: path = os.path.normcase(file) # create the media if controller.media_info.media_type == MediaType.CD: if is_win(): path = '/' + path controller.vlc_media = controller.vlc_instance.media_new_location('cdda://' + path) controller.vlc_media_player.set_media(controller.vlc_media) controller.vlc_media_player.play() # Wait for media to start playing. In this case VLC actually returns an error. self.media_state_wait(controller, vlc.State.Playing) # If subitems exists, this is a CD audio_cd_tracks = controller.vlc_media.subitems() if not audio_cd_tracks or audio_cd_tracks.count() < 1: return False controller.vlc_media = audio_cd_tracks.item_at_index(int(controller.media_info.title_track)) if not controller.vlc_media: return False # VLC's start and stop time options work on seconds controller.vlc_media.add_option(f"start-time={int(controller.media_info.start_time // 1000)}") controller.vlc_media.add_option(f"stop-time={int(controller.media_info.end_time // 1000)}") controller.vlc_media_player.set_media(controller.vlc_media) elif controller.media_info.media_type == MediaType.DVD: if is_win(): path = '/' + path dvd_location = 'dvd://' + path + '#' + controller.media_info.title_track controller.vlc_media = controller.vlc_instance.media_new_location(dvd_location) log.debug(f"vlc dvd load: {dvd_location}") controller.vlc_media.add_option(f"start-time={int(controller.media_info.start_time // 1000)}") controller.vlc_media.add_option(f"stop-time={int(controller.media_info.end_time // 1000)}") controller.vlc_media_player.set_media(controller.vlc_media) controller.vlc_media_player.play() # Wait for media to start playing. In this case VLC returns an error. self.media_state_wait(controller, vlc.State.Playing) if controller.media_info.audio_track > 0: res = controller.vlc_media_player.audio_set_track(controller.media_info.audio_track) log.debug('vlc play, audio_track set: ' + str(controller.media_info.audio_track) + ' ' + str(res)) if controller.media_info.subtitle_track > 0: res = controller.vlc_media_player.video_set_spu(controller.media_info.subtitle_track) log.debug('vlc play, subtitle_track set: ' + str(controller.media_info.subtitle_track) + ' ' + str(res)) elif controller.media_info.media_type == MediaType.Stream: controller.vlc_media = controller.vlc_instance.media_new_location(file[0]) controller.vlc_media.add_options(file[1]) controller.vlc_media_player.set_media(controller.vlc_media) else: controller.vlc_media = controller.vlc_instance.media_new_path(path) controller.vlc_media_player.set_media(controller.vlc_media) controller.media_info.start_time = 0 controller.media_info.end_time = controller.media_info.length # parse the metadata of the file controller.vlc_media.parse() controller.seek_slider.setMinimum(controller.media_info.start_time) controller.seek_slider.setMaximum(controller.media_info.end_time) self.volume(controller, controller.media_info.volume) return True def media_state_wait(self, controller, media_state): """ Wait for the video to change its state Wait no longer than 60 seconds. (loading an iso file needs a long time) :param media_state: The state of the playing media :param controller: The controller where the media is :return: """ vlc = get_vlc() start = datetime.now() while media_state != controller.vlc_media.get_state(): sleep(0.1) if controller.vlc_media.get_state() == vlc.State.Error: return False self.application.process_events() if (datetime.now() - start).seconds > 60: return False return True def resize(self, controller): """ Resize the player :param controller: The display where the media is stored within the controller. :return: """ if controller.is_live: controller.vlc_widget.setGeometry(ScreenList().current.display_geometry) else: controller.vlc_widget.resize(controller.preview_display.size()) def play(self, controller, output_display): """ Play the current item :param controller: Which Controller is running the show. :param output_display: The display where the media is :return: """ vlc = get_vlc() log.debug('vlc play, mediatype: ' + str(controller.media_info.media_type)) threading.Thread(target=controller.vlc_media_player.play).start() if not self.media_state_wait(controller, vlc.State.Playing): return False self.volume(controller, controller.media_info.volume) self.set_state(MediaState.Playing, controller) return True def pause(self, controller): """ Pause the current item :param controller: The controller which is managing the display :return: """ vlc = get_vlc() if controller.vlc_media.get_state() != vlc.State.Playing: return controller.vlc_media_player.pause() if self.media_state_wait(controller, vlc.State.Paused): self.set_state(MediaState.Paused, controller) def stop(self, controller): """ Stop the current item :param controller: The controller where the media is :return: """ threading.Thread(target=controller.vlc_media_player.stop).start() self.set_state(MediaState.Stopped, controller) def volume(self, controller, vol): """ Set the volume :param vol: The volume to be sets :param controller: The controller where the media is :return: """ controller.vlc_media_player.audio_set_volume(vol) def seek(self, controller, seek_value): """ Go to a particular position :param seek_value: The position of where a seek goes to :param controller: The controller where the media is """ if controller.vlc_media_player.is_seekable(): controller.vlc_media_player.set_time(seek_value) def reset(self, controller): """ Reset the player :param controller: The controller where the media is """ controller.vlc_media_player.stop() self.set_state(MediaState.Off, controller) def set_visible(self, controller, status): """ Set the visibility :param controller: The controller where the media display is :param status: The visibility status """ controller.vlc_widget.setVisible(status) def update_ui(self, controller, output_display): """ Update the UI :param controller: Which Controller is running the show. :param output_display: The display where the media is """ if not controller.seek_slider.isSliderDown(): controller.seek_slider.blockSignals(True) controller.seek_slider.setSliderPosition(controller.vlc_media_player.get_time()) controller.seek_slider.blockSignals(False)