はじめに

動作要件

Node.js 18 以上（または fetch をネイティブサポートするランタイム: Deno, Bun, Cloudflare Workers）
プラットフォームの API 認証情報（プラットフォームプラグインを参照）

インストール

コアパッケージと必要なプラットフォームプラグインをインストールします:

# Core + YouTube
pnpm add @unified-live/core @unified-live/youtube

# Core + 全プラットフォーム
pnpm add @unified-live/core @unified-live/youtube @unified-live/twitch @unified-live/twitcasting

クイックスタート

import { UnifiedClient } from "@unified-live/core";
import { createYouTubePlugin } from "@unified-live/youtube";
import { createTwitchPlugin } from "@unified-live/twitch";

// 1. プラットフォームプラグインを指定してクライアントを作成
// 末尾の `!` は非nullアサーション — 環境変数が設定済みであることを確認してください
const client = UnifiedClient.create({
  plugins: [
    createYouTubePlugin({ apiKey: process.env.YOUTUBE_API_KEY! }),
    createTwitchPlugin({
      clientId: process.env.TWITCH_CLIENT_ID!,
      clientSecret: process.env.TWITCH_CLIENT_SECRET!,
    }),
  ],
});

// 2. URL からコンテンツを取得 — プラットフォームは自動判別
const content = await client.resolve("https://www.youtube.com/watch?v=dQw4w9WgXcQ");

console.log(content.title); // 動画タイトル
console.log(content.platform); // "youtube"
console.log(content.type); // "broadcast", "scheduled", "archive", または "clip"

次のステップ

概要 — unified-live を使う理由とプラットフォーム API 比較
基本概念 — Content, Channel, 型システム
プラットフォームプラグイン — 各プラットフォームの設定
エラーハンドリング — API エラーの処理