459 lines
16 KiB
Python
459 lines
16 KiB
Python
import time
|
|
from typing import (
|
|
Any,
|
|
Dict,
|
|
List,
|
|
Optional
|
|
)
|
|
|
|
from discord import (
|
|
Client,
|
|
Guild,
|
|
VoiceChannel,
|
|
VoiceProtocol
|
|
)
|
|
from discord.ext import commands
|
|
|
|
from . import events
|
|
from .enums import SearchType
|
|
from .events import PomiceEvent, TrackEndEvent, TrackStartEvent
|
|
from .exceptions import FilterInvalidArgument, FilterTagAlreadyInUse, FilterTagInvalid, TrackInvalidPosition, TrackLoadError
|
|
from .filters import Filter
|
|
from .objects import Track
|
|
from .pool import Node, NodePool
|
|
|
|
class Filters:
|
|
"""Helper class for filters"""
|
|
def __init__(self):
|
|
self._filters: List[Filter] = []
|
|
|
|
@property
|
|
def has_preload(self):
|
|
"""Property which checks if any applied filters were preloaded"""
|
|
return any(f for f in self._filters if f.preload == True)
|
|
|
|
@property
|
|
def has_global(self):
|
|
"""Property which checks if any applied filters are global"""
|
|
return any(f for f in self._filters if f.preload == False)
|
|
|
|
@property
|
|
def empty(self):
|
|
"""Property which checks if the filter list is empty"""
|
|
return len(self._filters) == 0
|
|
|
|
|
|
def add_filter(self, *, filter: Filter):
|
|
"""Adds a filter to the list of filters applied"""
|
|
if any(f for f in self._filters if f.tag == filter.tag):
|
|
raise FilterTagAlreadyInUse(
|
|
"A filter with that tag is already in use."
|
|
)
|
|
self._filters.append(filter)
|
|
|
|
def remove_filter(self, *, filter_tag: str):
|
|
"""Removes a filter from the list of filters applied using its filter tag"""
|
|
if not any(f for f in self._filters if f.tag == filter_tag):
|
|
raise FilterTagInvalid(
|
|
"A filter with that tag was not found."
|
|
)
|
|
|
|
for index, filter in enumerate(self._filters):
|
|
if filter.tag == filter_tag:
|
|
del self._filters[index]
|
|
|
|
def has_filter(self, *, filter_tag: str):
|
|
"""Checks if a filter exists in the list of filters using its filter tag"""
|
|
return any(f for f in self._filters if f.tag == filter_tag)
|
|
|
|
def reset_filters(self):
|
|
"""Removes all filters from the list"""
|
|
self._filters = []
|
|
|
|
def get_preload_filters(self):
|
|
"""Get all preloaded filters"""
|
|
return [f for f in self._filters if f.preload == True]
|
|
|
|
def get_all_payloads(self):
|
|
"""Returns a formatted dict of all the filter payloads"""
|
|
payload = {}
|
|
for filter in self._filters:
|
|
payload.update(filter.payload)
|
|
return payload
|
|
|
|
def get_filters(self):
|
|
"""Returns the current list of applied filters"""
|
|
return self._filters
|
|
|
|
|
|
|
|
class Player(VoiceProtocol):
|
|
"""The base player class for Pomice.
|
|
In order to initiate a player, you must pass it in as a cls when you connect to a channel.
|
|
i.e: ```py
|
|
await ctx.author.voice.channel.connect(cls=pomice.Player)
|
|
```
|
|
"""
|
|
|
|
def __call__(self, client: Client, channel: VoiceChannel):
|
|
self.client: Client = client
|
|
self.channel: VoiceChannel = channel
|
|
self._guild: Guild = channel.guild
|
|
|
|
return self
|
|
|
|
def __init__(
|
|
self,
|
|
client: Optional[Client] = None,
|
|
channel: Optional[VoiceChannel] = None,
|
|
*,
|
|
node: Node = None
|
|
):
|
|
self.client = client
|
|
self._bot = client
|
|
self.channel = channel
|
|
self._guild = channel.guild if channel else None
|
|
|
|
self._node = node if node else NodePool.get_node()
|
|
self._current: Track = None
|
|
self._filters: Filters = Filters()
|
|
self._volume = 100
|
|
self._paused = False
|
|
self._is_connected = False
|
|
|
|
self._position = 0
|
|
self._last_position = 0
|
|
self._last_update = 0
|
|
self._ending_track: Optional[Track] = None
|
|
|
|
self._voice_state = {}
|
|
|
|
def __repr__(self):
|
|
return (
|
|
f"<Pomice.player bot={self.bot} guildId={self.guild.id} "
|
|
f"is_connected={self.is_connected} is_playing={self.is_playing}>"
|
|
)
|
|
|
|
@property
|
|
def position(self) -> float:
|
|
"""Property which returns the player's position in a track in milliseconds"""
|
|
current = self._current.original
|
|
|
|
if not self.is_playing or not self._current:
|
|
return 0
|
|
|
|
if self.is_paused:
|
|
return min(self._last_position, current.length)
|
|
|
|
difference = (time.time() * 1000) - self._last_update
|
|
position = self._last_position + difference
|
|
|
|
if position > current.length:
|
|
return 0
|
|
|
|
return min(position, current.length)
|
|
|
|
@property
|
|
def is_playing(self) -> bool:
|
|
"""Property which returns whether or not the player is actively playing a track."""
|
|
return self._is_connected and self._current is not None
|
|
|
|
@property
|
|
def is_connected(self) -> bool:
|
|
"""Property which returns whether or not the player is connected"""
|
|
return self._is_connected
|
|
|
|
@property
|
|
def is_paused(self) -> bool:
|
|
"""Property which returns whether or not the player has a track which is paused or not."""
|
|
return self._is_connected and self._paused
|
|
|
|
@property
|
|
def current(self) -> Track:
|
|
"""Property which returns the currently playing track"""
|
|
return self._current
|
|
|
|
@property
|
|
def node(self) -> Node:
|
|
"""Property which returns the node the player is connected to"""
|
|
return self._node
|
|
|
|
@property
|
|
def guild(self) -> Guild:
|
|
"""Property which returns the guild associated with the player"""
|
|
return self._guild
|
|
|
|
@property
|
|
def volume(self) -> int:
|
|
"""Property which returns the players current volume"""
|
|
return self._volume
|
|
|
|
@property
|
|
def filters(self) -> Filters:
|
|
"""Property which returns the helper class for interacting with filters"""
|
|
return self._filters
|
|
|
|
@property
|
|
def bot(self) -> Client:
|
|
"""Property which returns the bot associated with this player instance"""
|
|
return self._bot
|
|
|
|
@property
|
|
def is_dead(self) -> bool:
|
|
"""Returns a bool representing whether the player is dead or not.
|
|
A player is considered dead if it has been destroyed and removed from stored players.
|
|
"""
|
|
return self.guild.id not in self._node._players
|
|
|
|
async def _update_state(self, data: dict):
|
|
state: dict = data.get("state")
|
|
self._last_update = time.time() * 1000
|
|
self._is_connected = state.get("connected")
|
|
self._last_position = state.get("position")
|
|
|
|
async def _dispatch_voice_update(self, voice_data: Dict[str, Any]):
|
|
if {"sessionId", "event"} != self._voice_state.keys():
|
|
return
|
|
|
|
await self._node.send(
|
|
op="voiceUpdate",
|
|
guildId=str(self.guild.id),
|
|
**voice_data
|
|
)
|
|
|
|
async def on_voice_server_update(self, data: dict):
|
|
self._voice_state.update({"event": data})
|
|
await self._dispatch_voice_update(self._voice_state)
|
|
|
|
async def on_voice_state_update(self, data: dict):
|
|
self._voice_state.update({"sessionId": data.get("session_id")})
|
|
|
|
if not (channel_id := data.get("channel_id")):
|
|
await self.disconnect()
|
|
self._voice_state.clear()
|
|
return
|
|
|
|
self.channel = self.guild.get_channel(int(channel_id))
|
|
|
|
if not data.get("token"):
|
|
return
|
|
|
|
await self._dispatch_voice_update({**self._voice_state, "event": data})
|
|
|
|
async def _dispatch_event(self, data: dict):
|
|
event_type = data.get("type")
|
|
event: PomiceEvent = getattr(events, event_type)(data, self)
|
|
|
|
if isinstance(event, TrackEndEvent) and event.reason != "REPLACED":
|
|
self._current = None
|
|
|
|
event.dispatch(self._bot)
|
|
|
|
if isinstance(event, TrackStartEvent):
|
|
self._ending_track = self._current
|
|
|
|
async def get_tracks(
|
|
self,
|
|
query: str,
|
|
*,
|
|
ctx: Optional[commands.Context] = None,
|
|
search_type: SearchType = SearchType.ytsearch,
|
|
filters: Optional[List[Filter]] = None
|
|
):
|
|
"""Fetches tracks from the node's REST api to parse into Lavalink.
|
|
|
|
If you passed in Spotify API credentials when you created the node,
|
|
you can also pass in a Spotify URL of a playlist, album or track and it will be parsed
|
|
accordingly.
|
|
|
|
You can pass in a discord.py Context object to get a
|
|
Context object on any track you search.
|
|
|
|
You may also pass in a List of filters
|
|
to be applied to your track once it plays.
|
|
"""
|
|
return await self._node.get_tracks(query, ctx=ctx, search_type=search_type, filters=filters)
|
|
|
|
async def connect(self, *, timeout: float, reconnect: bool, self_deaf: bool = False, self_mute: bool = False):
|
|
await self.guild.change_voice_state(channel=self.channel, self_deaf=self_deaf, self_mute=self_mute)
|
|
self._node._players[self.guild.id] = self
|
|
self._is_connected = True
|
|
|
|
async def stop(self):
|
|
"""Stops the currently playing track."""
|
|
self._current = None
|
|
await self._node.send(op="stop", guildId=str(self.guild.id))
|
|
|
|
async def disconnect(self, *, force: bool = False):
|
|
"""Disconnects the player from voice."""
|
|
try:
|
|
await self.guild.change_voice_state(channel=None)
|
|
finally:
|
|
self.cleanup()
|
|
self._is_connected = False
|
|
self.channel = None
|
|
|
|
async def destroy(self):
|
|
"""Disconnects and destroys the player, and runs internal cleanup."""
|
|
try:
|
|
await self.disconnect()
|
|
except AttributeError:
|
|
# 'NoneType' has no attribute '_get_voice_client_key' raised by self.cleanup() ->
|
|
# assume we're already disconnected and cleaned up
|
|
assert self.channel is None and not self.is_connected
|
|
|
|
self._node._players.pop(self.guild.id)
|
|
await self._node.send(op="destroy", guildId=str(self.guild.id))
|
|
|
|
async def play(
|
|
self,
|
|
track: Track,
|
|
*,
|
|
start: int = 0,
|
|
end: int = 0,
|
|
ignore_if_playing: bool = False
|
|
) -> Track:
|
|
"""Plays a track. If a Spotify track is passed in, it will be handled accordingly."""
|
|
|
|
# Make sure we've never searched the track before
|
|
if track.original is None:
|
|
# First lets try using the tracks ISRC, every track has one (hopefully)
|
|
try:
|
|
if not track.isrc:
|
|
# We have to bare raise here because theres no other way to skip this block feasibly
|
|
raise
|
|
search: Track = (await self._node.get_tracks(
|
|
f"{track._search_type}:{track.isrc}", ctx=track.ctx))[0]
|
|
except Exception:
|
|
# First method didn't work, lets try just searching it up
|
|
try:
|
|
search: Track = (await self._node.get_tracks(
|
|
f"{track._search_type}:{track.title} - {track.author}", ctx=track.ctx))[0]
|
|
except:
|
|
# The song wasn't able to be found, raise error
|
|
raise TrackLoadError (
|
|
"No equivalent track was able to be found."
|
|
)
|
|
data = {
|
|
"op": "play",
|
|
"guildId": str(self.guild.id),
|
|
"track": search.track_id,
|
|
"startTime": str(start),
|
|
"noReplace": ignore_if_playing
|
|
}
|
|
track.original = search
|
|
track.track_id = search.track_id
|
|
# Set track_id for later lavalink searches
|
|
else:
|
|
data = {
|
|
"op": "play",
|
|
"guildId": str(self.guild.id),
|
|
"track": track.track_id,
|
|
"startTime": str(start),
|
|
"noReplace": ignore_if_playing
|
|
}
|
|
|
|
|
|
# Remove preloaded filters if last track had any
|
|
if self.filters.has_preload:
|
|
for filter in self.filters.get_preload_filters():
|
|
await self.remove_filter(filter_tag=filter.tag)
|
|
|
|
# Global filters take precedence over track filters
|
|
# So if no global filters are detected, lets apply any
|
|
# necessary track filters
|
|
|
|
# Check if theres no global filters and if the track has any filters
|
|
# that need to be applied
|
|
if track.filters and not self.filters.has_global:
|
|
# Now apply all filters
|
|
for filter in track.filters:
|
|
await self.add_filter(filter=filter)
|
|
|
|
if end > 0:
|
|
data["endTime"] = str(end)
|
|
|
|
await self._node.send(**data)
|
|
|
|
self._current = track
|
|
return self._current
|
|
|
|
async def seek(self, position: float) -> float:
|
|
"""Seeks to a position in the currently playing track milliseconds"""
|
|
if position < 0 or position > self._current.original.length:
|
|
raise TrackInvalidPosition(
|
|
"Seek position must be between 0 and the track length"
|
|
)
|
|
|
|
await self._node.send(op="seek", guildId=str(self.guild.id), position=position)
|
|
return self._position
|
|
|
|
async def set_pause(self, pause: bool) -> bool:
|
|
"""Sets the pause state of the currently playing track."""
|
|
await self._node.send(op="pause", guildId=str(self.guild.id), pause=pause)
|
|
self._paused = pause
|
|
return self._paused
|
|
|
|
async def set_volume(self, volume: int) -> int:
|
|
"""Sets the volume of the player as an integer. Lavalink accepts values from 0 to 500."""
|
|
await self._node.send(op="volume", guildId=str(self.guild.id), volume=volume)
|
|
self._volume = volume
|
|
return self._volume
|
|
|
|
async def add_filter(self, filter: Filter, fast_apply: bool = False) -> Filter:
|
|
"""Adds a filter to the player. Takes a pomice.Filter object.
|
|
This will only work if you are using a version of Lavalink that supports filters.
|
|
If you would like for the filter to apply instantly, set the `fast_apply` arg to `True`.
|
|
|
|
(You must have a song playing in order for `fast_apply` to work.)
|
|
"""
|
|
|
|
self._filters.add_filter(filter=filter)
|
|
payload = self._filters.get_all_payloads()
|
|
await self._node.send(op="filters", guildId=str(self.guild.id), **payload)
|
|
if fast_apply:
|
|
await self.seek(self.position)
|
|
|
|
return self._filters
|
|
|
|
async def remove_filter(self, filter_tag: str, fast_apply: bool = False) -> Filter:
|
|
"""Removes a filter from the player. Takes a filter tag.
|
|
This will only work if you are using a version of Lavalink that supports filters.
|
|
If you would like for the filter to apply instantly, set the `fast_apply` arg to `True`.
|
|
|
|
(You must have a song playing in order for `fast_apply` to work.)
|
|
"""
|
|
|
|
self._filters.remove_filter(filter_tag=filter_tag)
|
|
payload = self._filters.get_all_payloads()
|
|
await self._node.send(op="filters", guildId=str(self.guild.id), **payload)
|
|
if fast_apply:
|
|
await self.seek(self.position)
|
|
|
|
return self._filters
|
|
|
|
async def reset_filters(self, *, fast_apply: bool = False):
|
|
"""Resets all currently applied filters to their default parameters.
|
|
You must have filters applied in order for this to work.
|
|
If you would like the filters to be removed instantly, set the `fast_apply` arg to `True`.
|
|
|
|
(You must have a song playing in order for `fast_apply` to work.)
|
|
"""
|
|
|
|
if not self._filters:
|
|
raise FilterInvalidArgument(
|
|
"You must have filters applied first in order to use this method."
|
|
)
|
|
self._filters.reset_filters()
|
|
await self._node.send(op="filters", guildId=str(self.guild.id))
|
|
|
|
|
|
if fast_apply:
|
|
await self.seek(self.position)
|
|
|
|
|
|
|
|
|
|
|
|
|