def media_player(media, is_widescreen=False, show_like=True, show_dislike=True,
show_download=False, show_embed=False, show_playerbar=True,
show_popout=True, show_resize=False, show_share=True,
js_init=None, **kwargs):
"""Instantiate and render the preferred player that can play this media.
We make no effort to pick the "best" player here, we simply return
the first player that *can* play any of the URIs associated with
the given media object. It's up to the user to declare their own
preferences wisely.
Player preferences are fetched from the database and the
:attr:`mediacore.model.players.c.data` dict is passed as kwargs to
:meth:`AbstractPlayer.__init__`.
:type media: :class:`mediacore.model.media.Media`
:param media: A media instance to play.
:param js_init: Optional function to call after the javascript player
controller has been instantiated. Example of a function literal:
``function(controller){ controller.setFillScreen(true); }``.
Any function reference can be used as long as it is defined
in all pages and accepts the JS player controller as its first
and only argument.
:param \*\*kwargs: Extra kwargs for :meth:`AbstractPlayer.__init__`.
:rtype: `str` or `None`
:returns: A rendered player.
"""
uris = media.get_uris()
# Find the first player that can play any uris
for player_cls, player_data in fetch_enabled_players():
can_play = player_cls.can_play(uris)
if any(can_play):
break
else:
return None
# Grab just the uris that the chosen player can play
playable_uris = [uri for uri, plays in izip(uris, can_play) if plays]
kwargs['data'] = player_data
player = player_cls(media, playable_uris, **kwargs)
return render('players/html5_or_flash.html', {
'player': player,
'media': media,
'uris': uris,
'is_widescreen': is_widescreen,
'js_init': js_init,
'show_like': show_like,
'show_dislike': show_dislike,
'show_download': show_download,
'show_embed': show_embed,
'show_playerbar': show_playerbar,
'show_popout': show_popout,
'show_resize': show_resize and player.supports_resizing,
'show_share': show_share,
})
def pick_any_media_file(media):
"""Return a file playable in at least one of the configured players.
:param media: A :class:`~mediacore.model.media.Media` instance.
:returns: A :class:`~mediacore.model.media.MediaFile` object or None
"""
uris = media.get_uris()
for player_cls, player_data in fetch_enabled_players():
for i, plays in enumerate(player_cls.can_play(uris)):
if plays:
return uris[i]
return None
def pick_any_media_file(media):
"""Return a file playable in at least one of the configured players.
:param media: A :class:`~mediacore.model.media.Media` instance.
:returns: A :class:`~mediacore.model.media.MediaFile` object or None
"""
uris = media.get_uris()
for player_cls, player_data in fetch_enabled_players():
for i, plays in enumerate(player_cls.can_play(uris)):
if plays:
return uris[i]
return None
def preferred_player_for_media(media, **kwargs):
uris = media.get_uris()
from mediacore.model.players import fetch_enabled_players
# Find the first player that can play any uris
for player_cls, player_data in fetch_enabled_players():
can_play = player_cls.can_play(uris)
if any(can_play):
break
else:
return None
# Grab just the uris that the chosen player can play
playable_uris = [uri for uri, plays in izip(uris, can_play) if plays]
kwargs['data'] = player_data
return player_cls(media, playable_uris, **kwargs)
def preferred_player_for_media(media, **kwargs):
uris = media.get_uris()
from mediacore.model.players import fetch_enabled_players
# Find the first player that can play any uris
for player_cls, player_data in fetch_enabled_players():
can_play = player_cls.can_play(uris)
if any(can_play):
break
else:
return None
# Grab just the uris that the chosen player can play
playable_uris = [uri for uri, plays in izip(uris, can_play) if plays]
kwargs['data'] = player_data
return player_cls(media, playable_uris, **kwargs)
def media_player(media,
is_widescreen=False,
show_like=True,
show_dislike=True,
show_download=False,
show_embed=False,
show_playerbar=True,
show_popout=True,
show_resize=False,
show_share=True,
js_init=None,
**kwargs):
"""Instantiate and render the preferred player that can play this media.
We make no effort to pick the "best" player here, we simply return
the first player that *can* play any of the URIs associated with
the given media object. It's up to the user to declare their own
preferences wisely.
Player preferences are fetched from the database and the
:attr:`mediacore.model.players.c.data` dict is passed as kwargs to
:meth:`AbstractPlayer.__init__`.
:type media: :class:`mediacore.model.media.Media`
:param media: A media instance to play.
:param js_init: Optional function to call after the javascript player
controller has been instantiated. Example of a function literal:
``function(controller){ controller.setFillScreen(true); }``.
Any function reference can be used as long as it is defined
in all pages and accepts the JS player controller as its first
and only argument.
:param \*\*kwargs: Extra kwargs for :meth:`AbstractPlayer.__init__`.
:rtype: `str` or `None`
:returns: A rendered player.
"""
uris = media.get_uris()
# Find the first player that can play any uris
for player_cls, player_data in fetch_enabled_players():
can_play = player_cls.can_play(uris)
if any(can_play):
break
else:
return None
# Grab just the uris that the chosen player can play
playable_uris = [uri for uri, plays in izip(uris, can_play) if plays]
kwargs['data'] = player_data
player = player_cls(media, playable_uris, **kwargs)
return render(
'players/html5_or_flash.html', {
'player': player,
'media': media,
'uris': uris,
'is_widescreen': is_widescreen,
'js_init': js_init,
'show_like': show_like,
'show_dislike': show_dislike,
'show_download': show_download,
'show_embed': show_embed,
'show_playerbar': show_playerbar,
'show_popout': show_popout,
'show_resize': show_resize and player.supports_resizing,
'show_share': show_share,
})