soundcloud-api-ts-next
    Preparing search index...

    Function usePlayer

    • Control audio playback for a SoundCloud track.

      Fetches the stream URL and creates an HTMLAudioElement internally. Provides play/pause/toggle/seek controls and reactive progress/duration state.

      Parameters

      • trackId: string | number | undefined

        The track ID to stream. Pass undefined to stop/skip playback.

      Returns PlayerState

      A PlayerState object with playback controls and state.

      import { usePlayer } from "soundcloud-api-ts-next";

      function Player({ trackId }: { trackId: number }) {
      const { playing, progress, duration, toggle, seek } = usePlayer(trackId);
      return (
      <div>
      <button onClick={toggle}>{playing ? "Pause" : "Play"}</button>
      <span>{Math.round(progress)}s / {Math.round(duration)}s</span>
      </div>
      );
      }

      useTrack for fetching track metadata