videosdk 0.0.1__tar.gz

videosdk-0.0.1/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.1
+Name: videosdk
+Version: 0.0.1
+Summary: VideoSDK Python SDK
+Author: videosdk
+Author-email: sdk@videosdk.live
+License: MIT
+Project-URL: Home, https://docs.videosdk.live
+Project-URL: Documentation, https://docs.videosdk.live
+Project-URL: Source, https://docs.videosdk.live
+Project-URL: Website, https://videosdk.live
+Keywords: ml,webrtc,audio,video,ai,videosdk
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Communications :: Conferencing
+Classifier: Topic :: Multimedia :: Sound/Audio
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: pydantic<1.11.0,>=1.10.15
+Requires-Dist: vsaiortc>=0.0.1
+Requires-Dist: h264-profile-level-id<1.1.0,>=1.0.0
+Requires-Dist: sdp-transform<1.2.0,>=1.1.0
+Requires-Dist: pyee<11.2.0,>=11.1.0
+Requires-Dist: av<11.1.0,>=11.0.0
+Requires-Dist: websockets<12.1.0,>=12.0.0
+Requires-Dist: requests<2.32.0,>=2.3.1
+Requires-Dist: pycryptodome==3.20.0
+
+# VideoSDK Python SDK
+
+## Overview
+
+The VideoSDK Python SDK provides a convenient way to interact with the VideoSDK API. It allows you to integrate video functionalities, including video calling, recording, and streaming, into your Python applications easily.
+
+## Features
+
+- **Video Calling**: Start, join, and manage video calls.
+- **Recording**: Record video calls.
+- **Live Streaming**: Stream your video calls to platforms like YouTube, Facebook, etc.
+- **Chat**: Send and receive messages during a video call.
+
+## Installation
+
+To install the SDK, use pip:
+
+```bash
+pip install videosdk
+```
+
+## Documentation
+
+For detailed documentation, visit the [VideoSDK Documentation](https://docs.videosdk.live).
+
+## Support
+
+If you need help or have any questions, please feel free to reach out to our support team at [support@videosdk.live](mailto:support@videosdk.live) or join our community forum.

videosdk-0.0.1/README.md

@@ -0,0 +1,28 @@
+# VideoSDK Python SDK
+
+## Overview
+
+The VideoSDK Python SDK provides a convenient way to interact with the VideoSDK API. It allows you to integrate video functionalities, including video calling, recording, and streaming, into your Python applications easily.
+
+## Features
+
+- **Video Calling**: Start, join, and manage video calls.
+- **Recording**: Record video calls.
+- **Live Streaming**: Stream your video calls to platforms like YouTube, Facebook, etc.
+- **Chat**: Send and receive messages during a video call.
+
+## Installation
+
+To install the SDK, use pip:
+
+```bash
+pip install videosdk
+```
+
+## Documentation
+
+For detailed documentation, visit the [VideoSDK Documentation](https://docs.videosdk.live).
+
+## Support
+
+If you need help or have any questions, please feel free to reach out to our support team at [support@videosdk.live](mailto:support@videosdk.live) or join our community forum.

videosdk-0.0.1/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "videosdk"
+version = "0.0.1"
+description = "VideoSDK Python SDK"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+keywords = ["ml", "webrtc", "audio", "video", "ai", "videosdk"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Communications :: Conferencing",
+    "Topic :: Multimedia :: Sound/Audio",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence"
+]
+dependencies = [
+    "pydantic >= 1.10.15, < 1.11.0",
+    "vsaiortc >= 0.0.1",
+    "h264-profile-level-id >= 1.0.0, < 1.1.0",
+    "sdp-transform >=1.1.0, < 1.2.0",
+    "pyee >= 11.1.0, < 11.2.0",
+    "av >= 11.0.0, < 11.1.0",
+    "websockets >= 12.0.0, < 12.1.0",
+    "requests >= 2.3.1, < 2.32.0",
+    "pycryptodome==3.20.0"
+]
+
+[project.urls]
+Home = "https://docs.videosdk.live"
+Documentation = "https://docs.videosdk.live"
+Source = "https://docs.videosdk.live"
+Website = "https://videosdk.live"
+
+[tool.coverage.run]
+source = ["videosdk"]

videosdk-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

videosdk-0.0.1/setup.py

@@ -0,0 +1,15 @@
+import setuptools
+
+with open("README.md", "r") as fh:
+    long_description = fh.read()
+
+setuptools.setup(
+  name="videosdk",
+  version="0.0.1",
+  long_description=long_description,
+  long_description_content_type="text/markdown",
+  author='videosdk',
+  author_email='sdk@videosdk.live',
+  license='MIT',
+  packages=setuptools.find_packages(exclude=["example"]),
+)

videosdk-0.0.1/videosdk/__init__.py

@@ -0,0 +1,10 @@
+from .exceptions import SDKError, InternalServerError, InvalidMeetingConfigError, MeetingError, MeetingInitializationError
+from .event_handler import MeetingEventHandler, ParticipantEventHandler
+from .participant import Participant
+from .videosdk import MeetingConfig, VideoSDK
+from .stream import Stream
+from .meeting import Meeting
+from .custom_audio_track import CustomAudioTrack
+from .custom_video_track import CustomVideoTrack
+
+__version__ = "0.0.1"

videosdk-0.0.1/videosdk/_events.py

@@ -0,0 +1,101 @@
+from enum import Enum
+
+class Events(Enum):
+  ADD_PEER = "ADD_PEER"
+  REMOVE_PEER = "REMOVE_PEER"
+  ADD_PRODUCER = "ADD_PRODUCER"
+  UPDATE_PRODUCER = "UPDATE_PRODUCER"
+  REMOVE_PRODUCER = "REMOVE_PRODUCER"
+  ADD_CONSUMER = "ADD_CONSUMER"
+  REMOVE_CONSUMER = "REMOVE_CONSUMER"
+  PARTICIPANT_MEDIA_STATE_CHANGED = "PARTICIPANT_MEDIA_STATE_CHANGED"
+  CHAT_MESSAGE = "CHAT_MESSAGE"
+  SET_ROOM_ACTIVE_SPEAKER = "SET_ROOM_ACTIVE_SPEAKER"
+  ENTRY_REQUESTED = "ENTRY_REQUESTED"
+  ENTRY_RESPONDED = "ENTRY_RESPONDED"
+  MEETING_JOINED = "MEETING_JOINED"
+  MEETING_LEFT = "MEETING_LEFT"
+  RECORDING_STATE_CHANGED = "RECORDING_STATE_CHANGED"
+  RECORDING_STARTED = "RECORDING_STARTED"
+  RECORDING_STOPPED = "RECORDING_STOPPED"
+  LIVESTREAM_STATE_CHANGED = "LIVESTREAM_STATE_CHANGED"
+  LIVESTREAM_STARTED = "LIVESTREAM_STARTED"
+  LIVESTREAM_STOPPED = "LIVESTREAM_STOPPED"
+  HLS_STATE_CHANGED = "HLS_STATE_CHANGED"
+  HLS_STARTED = "HLS_STARTED"
+  HLS_STOPPED = "HLS_STOPPED"
+  TRANSCRIPTION_STATE_CHANGED = "TRANSCRIPTION_STATE_CHANGED"
+  TRANSCRIPTION_TEXT = "TRANSCRIPTION_TEXT"
+  WHITEBOARD_STARTED = "WHITEBOARD_STARTED"
+  WHITEBOARD_STOPPED = "WHITEBOARD_STOPPED"
+  VIDEO_STATE_CHANGED = "VIDEO_STATE_CHANGED"
+  VIDEO_SEEKED = "VIDEO_SEEKED"
+  PIN_STATE_CHANGED = "PIN_STATE_CHANGED"
+  MIC_REQUESTED = "MIC_REQUESTED"
+  WEBCAM_REQUESTED = "WEBCAM_REQUESTED"
+  CONNECTION_OPEN = "CONNECTION_OPEN"
+  CONNECTION_CLOSE = "CONNECTION_CLOSE"
+  CONNECTION_PARTICIPANT_JOIN = "CONNECTION_PARTICIPANT_JOIN"
+  SWITCH_ROOM = "SWITCH_ROOM"
+  CONNECTION_CHAT_MESSAGE = "CONNECTION_CHAT_MESSAGE"
+  CONNECTION_PARTICIPANT_LEFT = "CONNECTION_PARTICIPANT_LEFT"
+  PUBSUB_MESSAGE = "PUBSUB_MESSAGE"
+  PEER_MODE_CHANGED = "PEER_MODE_CHANGED"
+  MEETING_STATE_CHANGED = "MEETING_STATE_CHANGED"
+  VIDEO_QUALITY_CHANGED = "VIDEO_QUALITY_CHANGED"
+  ADD_CHARACTER = "ADD_CHARACTER"
+  INIT_CHARACTER = "INIT_CHARACTER"
+  REMOVE_CHARACTER = "REMOVE_CHARACTER"
+  CHARACTER_STATE_CHANGED = "CHARACTER_STATE_CHANGED"
+  CHARACTER_TEXT = "CHARACTER_TEXT"
+  ERROR = "ERROR"
+
+
+class VideoSDKEvents(Enum):
+  EV_ERROR = "error"
+  EV_MEETING_JOINED = "meeting-joined"
+  EV_MEETING_LEFT = "meeting-left"
+  EV_PARTICIPANT_MODE_CHANGED = "participant-mode-changed"
+  EV_PARTICIPANT_JOINED = "participant-joined"
+  EV_PARTICIPANT_LEFT = "participant-left"
+  EV_SPEAKER_CHANGED = "speaker-changed"
+  EV_PRESENTER_CHANGED = "presenter-changed"
+  EV_MAIN_PARTICIPANT_CHANGED = "main-participant-changed"
+  EV_CHAT_MESSAGE = "chat-message"
+  EV_ENTRY_REQUESTED = "entry-requested"
+  EV_ENTRY_RESPONDED = "entry-responded"
+  EV_RECORDING_STATE_CHANGED = "recording-state-changed"
+  EV_RECORDING_STARTED = "recording-started"
+  EV_RECORDING_STOPPED = "recording-stopped"
+  EV_LIVESTREAM_STATE_CHANGED = "livestream-state-changed"
+  EV_LIVESTREAM_STARTED = "livestream-started"
+  EV_LIVESTREAM_STOPPED = "livestream-stopped"
+  EV_HLS_STATE_CHANGED = "hls-state-changed"
+  EV_HLS_STARTED = "hls-started"
+  EV_HLS_STOPPED = "hls-stopped"
+  EV_WHITEBOARD_STARTED = "whiteboard-started"
+  EV_WHITEBOARD_STOPPED = "whiteboard-stopped"
+  EV_VIDEO_STATE_CHANGED = "video-state-changed"
+  EV_VIDEO_SEEKED = "video-seeked"
+  EV_MIC_REQUESTED = "mic-requested"
+  EV_WEBCAM_REQUESTED = "webcam-requested"
+  
+  EV_PIN_STATE_CHANGED = "pin-state-changed"
+
+  EV_CONNECTION_OPEN = "connection-open"
+  EV_CONNECTION_CLOSE = "connection-close"
+  EV_SWITCH_MEETING = "switch-meeting"
+
+  EV_MEETING_STATE_CHANGE = "meeting-state-changed"
+
+  EV_TRANSCRIPTION_STATE_CHANGED = "transcription-state-changed"
+  EV_TRANSCRIPTION_TEXT = "transcription-text"
+
+  EV_CHARACTER_JOINED = "character-joined"
+  EV_CHARACTER_LEFT = "character-left"
+  
+  # Participant 
+  EV_STREAM_ENABLED = "stream-enabled"
+  EV_STREAM_DISABLED = "stream-disabled"
+  EV_MEDIA_STATUS_CHANGED = "media-status-changed"
+  EV_VIDEO_QUALITY_CHANGED = "video-quality-changed"

videosdk-0.0.1/videosdk/custom_audio_track.py

@@ -0,0 +1,50 @@
+import asyncio
+import fractions
+import time
+from vsaiortc.mediastreams import MediaStreamError, MediaStreamTrack
+from av import AudioFrame
+from av.frame import Frame
+from av.packet import Packet
+
+AUDIO_PTIME = 0.020
+
+class CustomAudioTrack(MediaStreamTrack):
+    """
+    A dummy audio track which reads silence.
+    """
+
+    kind = "audio"
+
+    _start: float
+    _timestamp: int
+
+    async def recv(self) -> Frame:
+        """
+        Receive the next :class:`~av.audio.frame.AudioFrame`.
+
+        The base implementation just reads silence, subclass
+        :class:`AudioStreamTrack` to provide a useful implementation.
+        """
+        if self.readyState != "live":
+            raise MediaStreamError
+
+        sample_rate = 8000
+        samples = int(AUDIO_PTIME * sample_rate)
+
+        if hasattr(self, "_timestamp"):
+            self._timestamp += samples
+            wait = self._start + (self._timestamp / sample_rate) - time.time()
+            await asyncio.sleep(wait)
+        else:
+            self._start = time.time()
+            self._timestamp = 0
+
+        frame = AudioFrame(format="s16", layout="mono", samples=samples)
+        for p in frame.planes:
+            p.update(bytes(p.buffer_size))
+        frame.pts = self._timestamp
+        frame.sample_rate = sample_rate
+        frame.time_base = fractions.Fraction(1, sample_rate)
+        
+        return frame
+

videosdk-0.0.1/videosdk/custom_video_track.py

@@ -0,0 +1,51 @@
+import asyncio
+import fractions
+import time
+from typing import Tuple
+from vsaiortc.mediastreams import MediaStreamError, MediaStreamTrack
+from av import VideoFrame
+from av.frame import Frame
+
+AUDIO_PTIME = 0.020  # default 20ms audio packetization 
+VIDEO_CLOCK_RATE = 90000
+VIDEO_PTIME = 1 / 30  # 30fps
+VIDEO_TIME_BASE = fractions.Fraction(1, VIDEO_CLOCK_RATE)
+
+class CustomVideoTrack(MediaStreamTrack):
+    """
+    A dummy video track which reads green frames.
+    """
+
+    kind = "video"
+
+    _start: float
+    _timestamp: int
+
+    async def next_timestamp(self) -> Tuple[int, fractions.Fraction]:
+        if self.readyState != "live":
+            raise MediaStreamError
+
+        if hasattr(self, "_timestamp"):
+            self._timestamp += int(VIDEO_PTIME * VIDEO_CLOCK_RATE)
+            wait = self._start + (self._timestamp / VIDEO_CLOCK_RATE) - time.time()
+            await asyncio.sleep(wait)
+        else:
+            self._start = time.time()
+            self._timestamp = 0
+        return self._timestamp, VIDEO_TIME_BASE
+
+    async def recv(self) -> Frame:
+        """
+        Receive the next :class:`~av.video.frame.VideoFrame`.
+
+        The base implementation just reads a 640x480 green frame at 30fps,
+        subclass :class:`VideoStreamTrack` to provide a useful implementation.
+        """
+        pts, time_base = await self.next_timestamp()
+
+        frame = VideoFrame(width=640, height=480)
+        for p in frame.planes:
+            p.update(bytes(p.buffer_size))
+        frame.pts = pts
+        frame.time_base = time_base
+        return frame

videosdk-0.0.1/videosdk/event_handler.py

@@ -0,0 +1,256 @@
+import logging
+from typing import final
+
+class BaseEvent:
+  """
+  VideoSDK BaseEvent Class
+  """
+  
+  @final
+  def handle_event(self, action, data):
+    method_name = {
+      # Base Event Handlers
+      "error": "on_error",
+      
+      # Meeting Event Handlers
+      "meeting-joined": "on_meeting_joined",
+      "meeting-left": "on_meeting_left",
+      "participant-mode-changed": "on_participant_mode_changed",
+      "participant-joined": "on_participant_joined",
+      "participant-left": "on_participant_left",
+      "speaker-changed": "on_speaker_changed",
+      "presenter-changed": "on_presenter_changed",
+      "main-participant-changed": "on_main_participant_changed",
+      "chat-message": "on_chat_message",
+      "entry-requested": "on_entry_requested",
+      "entry-responded": "on_entry_responded",
+      "recording-state-changed": "on_recording_state_changed",
+      "recording-started": "on_recording_started",
+      "recording-stopped": "on_recording_stopped",
+      "livestream-state-changed": "on_livestream_state_changed",
+      "livestream-started": "on_livestream_started",
+      "livestream-stopped": "on_livestream_stopped",
+      "hls-state-changed": "on_hls_state_changed",
+      "hls-started": "on_hls_started",
+      "hls-stopped": "on_hls_stopped",
+      "whiteboard-started": "on_whiteboard_started",
+      "whiteboard-stopped": "on_whiteboard_stopped",
+      "video-state-changed": "on_video_state_changed",
+      "video-seeked": "on_video_seeked",
+      "mic-requested": "on_mic_requested",
+      "webcam-requested": "on_webcam_requested",
+      "pin-state-changed": "on_pin_state_changed",
+      "connection-open": "on_connection_open",
+      "connection-close": "on_connection_close",
+      "switch-meeting": "on_switch_meeting",
+      "meeting-state-changed": "on_meeting_state_change",
+      "transcription-state-changed": "on_transcription_state_changed",
+      "transcription-text": "on_transcription_text",
+
+      # Participant Event Handlers
+      "stream-enabled": "on_stream_enabled",
+      "stream-disabled": "on_stream_disabled",
+      "media-status-changed": "on_media_status_changed",
+      "video-quality-changed": "on_video_quality_changed"
+    }.get(action, None)
+
+    if method_name is None:
+        logging.debug(f"unimplemented event handler {action}")
+        return
+
+    method = getattr(self, method_name, None)
+    if method:
+        method(data)
+    else:
+        logging.debug(f"No method found for {method_name}")
+
+  
+class MeetingEventHandler(BaseEvent):
+  def on_error(self, data):
+      """
+      Handle error event.
+      """
+
+  def on_meeting_joined(self, data):
+      """
+      Handle meeting joined event.
+      """
+
+  def on_meeting_left(self, data):
+      """
+      Handle meeting left event.
+      """
+
+  def on_participant_mode_changed(self, data):
+      """
+      Handle participant mode changed event.
+      """
+
+  def on_participant_joined(self, data):
+      """
+      Handle participant joined event.
+      """
+
+  def on_participant_left(self, data):
+      """
+      Handle participant left event.
+      """
+
+  def on_speaker_changed(self, data):
+      """
+      Handle speaker changed event.
+      """
+
+  def on_presenter_changed(self, data):
+      """
+      Handle presenter changed event.
+      """
+
+  def on_main_participant_changed(self, data):
+      """
+      Handle main participant changed event.
+      """
+
+  def on_chat_message(self, data):
+      """
+      Handle chat message event.
+      """
+
+  def on_entry_requested(self, data):
+      """
+      Handle entry requested event.
+      """
+
+  def on_entry_responded(self, data):
+      """
+      Handle entry responded event.
+      """
+
+  def on_recording_state_changed(self, data):
+      """
+      Handle recording state changed event.
+      """
+
+  def on_recording_started(self, data):
+      """
+      Handle recording started event.
+      """
+
+  def on_recording_stopped(self, data):
+      """
+      Handle recording stopped event.
+      """
+
+  def on_livestream_state_changed(self, data):
+      """
+      Handle livestream state changed event.
+      """
+
+  def on_livestream_started(self, data):
+      """
+      Handle livestream started event.
+      """
+
+  def on_livestream_stopped(self, data):
+      """
+      Handle livestream stopped event.
+      """
+
+  def on_hls_state_changed(self, data):
+      """
+      Handle HLS state changed event.
+      """
+
+  def on_hls_started(self, data):
+      """
+      Handle HLS started event.
+      """
+
+  def on_hls_stopped(self, data):
+      """
+      Handle HLS stopped event.
+      """
+
+  def on_whiteboard_started(self, data):
+      """
+      Handle whiteboard started event.
+      """
+
+  def on_whiteboard_stopped(self, data):
+      """
+      Handle whiteboard stopped event.
+      """
+
+  def on_video_state_changed(self, data):
+      """
+      Handle video state changed event.
+      """
+
+  def on_video_seeked(self, data):
+      """
+      Handle video seeked event.
+      """
+
+  def on_mic_requested(self, data):
+      """
+      Handle microphone requested event.
+      """
+
+  def on_webcam_requested(self, data):
+      """
+      Handle webcam requested event.
+      """
+
+  def on_pin_state_changed(self, data):
+      """
+      Handle pin state changed event.
+      """
+
+  def on_connection_open(self, data):
+      """
+      Handle connection open event.
+      """
+
+  def on_connection_close(self, data):
+      """
+      Handle connection close event.
+      """
+
+  def on_switch_meeting(self, data):
+      """
+      Handle switch meeting event.
+      """
+
+  def on_meeting_state_change(self, data):
+      """
+      Handle meeting state change event.
+      """
+
+  def on_transcription_state_changed(self, data):
+      """
+      Handle transcription state changed event.
+      """
+
+  def on_transcription_text(self, data):
+      """
+      Handle transcription text event.
+      """
+
+
+class ParticipantEventHandler(BaseEvent):
+  def on_stream_enabled(self, data)->None:
+    """
+    Handle Participant stream enabled event.
+    """
+  def on_stream_disabled(self, data)->None:
+    """
+    Handle Participant stream enabled event.
+    """
+  def on_media_status_changed(self, data)->None:
+    """
+    Handle Participant stream enabled event.
+    """
+  def on_video_quality_changed(self, data)->None:
+    """
+    Handle Participant stream enabled event.
+    """

videosdk-0.0.1/videosdk/exceptions.py

@@ -0,0 +1,39 @@
+class SDKError(Exception):
+    """Base class for all SDK exceptions."""
+    pass
+
+class InternalServerError(SDKError):
+    """Raised when there is an unhandled error error."""
+    def __init__(self, message="Internal Server Error"):
+        self.message = message
+        super().__init__(self.message)
+        
+class MeetingInitializationError(SDKError):
+    """Raised when there is an error in meeting initialization."""
+    def __init__(self, message="Failed to initialize meeting"):
+        self.message = message
+        super().__init__(self.message)
+
+class InvalidMeetingConfigError(SDKError):
+    """Raised when the meeting configuration is invalid."""
+    def __init__(self, message="Invalid meeting configuration"):
+        self.message = message
+        super().__init__(self.message)
+
+class ValidationError(SDKError):
+    """Raised when the Validation Failed."""
+    def __init__(self, message="Validation failed"):
+        self.message = message
+        super().__init__(self.message)
+
+class RTCError(SDKError):
+    """Raised when there is RTC error or server side error."""
+    def __init__(self, message="Error in RTC"):
+        self.message = message
+        super().__init__(self.message)
+        
+class MeetingError:
+    """class of meeting error."""
+    code: int
+    type: str
+    message: str

videosdk-0.0.1/videosdk/lib/__init__.py

@@ -0,0 +1 @@
+from .pymediasoup import *

videosdk-0.0.1/videosdk/lib/pymediasoup/__init__.py

@@ -0,0 +1,2 @@
+from .device import Device
+from .handlers.aiortc_handler import AiortcHandler

videosdk-0.0.1/videosdk/lib/pymediasoup/__version__.py

@@ -0,0 +1,3 @@
+VERSION = (0, 2, 2)
+
+__version__ = '.'.join(map(str, VERSION))