Vega Matterキャストの統合

[offers.matter-casting] 
vendor-id = <<CSA によって 付与された アプリ固有 の VID、 例： 65521>> 
product-id = <<CSA によって 付与された アプリ固有 の PID、 例： 5678>> 
vendor-name = "あなたのアプリ名"

schema-version = 1 
 
[package] 
title = "<アプリタイトル>" 
id = "com.amazondeveloper.media.sample" 
 
# --- コンポーネント --- 
 
[components] 
 
[[components.interactive]] 
id = "com.amazondeveloper.media.sample.main" 
runtime-module = "/com.amazon.kepler.keplerscript.runtime.loader_2@IKeplerScript_2_0" 
launch-type = "singleton" 
categories = ["com.amazon.category.main", "com.amazon.category.kepler.media"] 
 
# アカウントログイン用のサービスコンポーネント（ヘッドレス、UI なし）
[[components.service]] 
id = "com.amazondeveloper.media.sample.interface.provider" 
runtime-module = "/com.amazon.kepler.headless.runtime.loader_2@IKeplerScript_2_0" 
launch-type = "singleton" 
 
# --- プロセス --- 
 
[processes] 
 
[[processes.group]] 
component-ids = ["com.amazondeveloper.media.sample.main"] 
 
[[processes.group]] 
component-ids = ["com.amazondeveloper.media.sample.interface.provider"] 
 
# --- オファー --- 
 
# Matterキャストのアイデンティティ
[offers.matter-casting] 
vendor-id = 65521 
product-id = 5678 
vendor-name = "あなたのアプリ名" 
 
[[offers.interaction]] 
id = "com.amazondeveloper.media.sample.main" 
 
[[offers.service]] 
id = "com.amazondeveloper.media.sample.interface.provider" 
required-privileges = ["com.amazon.multimedia.privilege.session.manage"] 
 
[[offers.module]] 
id = "/com.amazondeveloper.media.sample.module@ISomeUri1" 
includes-messages = ["pkg://com.amazondeveloper.media.sample.main"] 
 
# --- メッセージング --- 
 
[[message]] 
uri = "pkg://com.amazondeveloper.media.sample.main" 
sender-privileges = ["*"] 
receiver-privileges = ["self"] 
 
# --- Vegaプラットフォームクラスター宣言 --- 
 
[[extras]] 
key = "interface.provider" 
component-id = "com.amazondeveloper.media.sample.main" 
 
[extras.value.application] 
 
# コンテンツランチャークラスター 
[[extras.value.application.interface]] 
interface_name = "com.amazon.kepler.media.IContentLauncherServer" 
attribute_options = ["partner-id"] 
static-values = { partner-id = "<パートナーID>" } 
 
# メディアコントロールクラスター 
[[extras.value.application.interface]] 
interface_name = "com.amazon.kepler.media.IMediaPlaybackServer" 
command_options = [ 
    "StartOver", 
    "Previous", 
    "Next", 
    "SkipForward", 
    "SkipBackward", 
] 
attribute_options = ["AudioAdvanceMuted"] 
features = ["AdvancedSeek", "VariableSpeed", "AudioTracks", "TextTracks"] 
 
# アカウントログインクラスター 
[[extras.value.application.interface]] 
interface_name = "com.amazon.kepler.media.IAccountLoginServer" 
attribute_options = ["Status"] 
# ルーティングアカウントのログインステータスがサービスコンポーネントに読み込まれる 
override_attribute_component = { Status = "com.amazondeveloper.media.sample.interface.provider" } 
 
# ターゲットナビゲータークラスター 
[[extras.value.application.interface]] 
interface_name = "com.amazon.kepler.media.ITargetNavigator" 
 
# --- 必須モジュール --- 
 
[needs] 
 
[[needs.module]] 
id = "/com.amazon.kepler.media@IContentLauncher1" 
 
[[needs.module]] 
# この形式で、「media」の後のドット（.）は意図的に追加されています。 
id = "/com.amazon.kepler.media.@IAccountLogin1"

{ 
  "dependencies": { 
    // コンテンツ ランチャー 
    "@amazon-devices/kepler-media-content-launcher": "^2.0.0", 

    // メディア コントロール 
    "@amazon-devices/kepler-media-controls": "~1.0.0", 
    "@amazon-devices/kepler-media-types": "~1.0.0", 

    // アカウント ログイン 
    "@amazon-devices/kepler-media-account-login": "^1.1.0", 
    "@amazon-devices/headless-task-manager": "^1.1.0", 

    "@amazon-devices/vega-target-navigator-provider": "*" 
  } 
}

export class ContentLauncherHandler {

  // --- Matter 0x00 LaunchContent（任意、CS機能が必要）と
  // 0x01 LaunchURL（任意、UP機能が必要）---
  //
  // コンテンツ起動は、同じhandleLaunchContentインターフェイスを介してサポートされています。
  // このため、スマートフォンがどちらのコマンド（LaunchURLかLaunchContent）
  // を送信しても、コンテンツアプリは同じように処理します。
  //
  // 重要 - レスポンスコントラクト：
  //   プロバイダーは返されたPromise<ILauncherResponse>を解決する必要があります。Matterキャスト
  //   サービスは25秒のコマンドタイムアウトを強制するため、プロバイダーは
  //   転送と処理のオーバーヘッドを考慮して20秒以内にILauncherResponseを
  //   返す必要があります。25秒以内に応答がない場合
  //   スマートフォンアプリはタイムアウトエラーを受け取ります。
  //
  async handleLaunchContent(
    contentSearch: IContentSearch,
    autoPlay: boolean,
    _optionalFields: ILaunchContentOptionalFields,
  ): Promise<ILauncherResponse> {

    if (autoPlay) {
      console.log('Content Launcher: autoPlay=true, starting playback');
    } else {
      console.log('Content Launcher: autoPlay=false, showing search results');
    }

    // 成功を返す - Matterキャストサービスはこれをステータス
    // SUCCESSのMatter LauncherResponse（0x02）に変換します
    return this.factory
      .makeLauncherResponseBuilder()
      .contentLauncherStatus(ContentLauncherStatusType.SUCCESS)
      .optionalData('Launch handled successfully')
      .build();

    // その他のステータスオプション：
    //   ContentLauncherStatusType.AUTH_FAILED      - ユーザーは承認されない
    //   ContentLauncherStatusType.URL_NOT_AVAILABLE - コンテンツが見つからない/その他のエラー
  }
}

export class MediaControlHandlerAsync implements IMediaControlHandlerAsync {

  // --- Matter 0x00 再生（必須） ---
  async handlePlay(_sessionId?: IMediaSessionId): Promise<void> {
    this.state.playbackStatus = PlaybackStatus.PLAYING;
    this.state.playbackSpeed = 1.0;
    this.pushState();
  }

  // --- Matter 0x01 一時停止（必須） ---
  async handlePause(
    _sessionId?: IMediaSessionId,
    _context?: ICommandContext,
  ): Promise<void> {
    this.state.playbackStatus = PlaybackStatus.PAUSED;
    this.pushState();
  }

  // --- Matter 0x02 停止（必須） ---
  async handleStop(_sessionId?: IMediaSessionId): Promise<void> {
    this.state.playbackStatus = PlaybackStatus.NOT_PLAYING;
    this.state.currentPosition = { seconds: 0, nanoseconds: 0 };
    this.pushState();
  }

  // --- Matter 0x03 スタートオーバー（任意） ---
  async handleStartOver(_sessionId?: IMediaSessionId): Promise<void> {
    this.state.playbackStatus = PlaybackStatus.PLAYING;
    this.state.currentPosition = { seconds: 0, nanoseconds: 0 };
    this.state.playbackPosition.position = { seconds: 0, nanoseconds: 0 };
    this.pushState();
  }

  // --- Matter 0x04 戻る（任意） ---
  async handlePrevious(): Promise<void> {
    // 前のトラックにスキップするビジネスロジック
  }

  // --- Matter 0x05 次へ（任意） ---
  async handleNext(_sessionId?: IMediaSessionId): Promise<void> {
    // 次のトラックにスキップするビジネスロジック
  }

  // --- Matter 0x06 早戻し（任意、VariableSpeed機能が必要） ---
  async handleRewind(_sessionId?: IMediaSessionId): Promise<void> {
    this.state.playbackStatus = PlaybackStatus.PLAYING;
    if (this.state.playbackSpeed > -5.0) {
      this.state.playbackSpeed =
        this.state.playbackSpeed <= -1.0
          ? this.state.playbackSpeed - 1.0
          : -1.0;
    }
    this.pushState();
  }

  // --- Matter 0x07 早送り（任意、VariableSpeed機能が必要） ---
  async handleFastForward(_sessionId?: IMediaSessionId): Promise<void> {
    this.state.playbackStatus = PlaybackStatus.PLAYING;
    if (this.state.playbackSpeed < 5.0) {
      this.state.playbackSpeed =
        this.state.playbackSpeed >= 1.0
          ? this.state.playbackSpeed + 1.0
          : 1.0;
    }
    this.pushState();
  }

  // --- Matter 0x08 スキップ送り（任意） ---
  async handleSkipForward(
    delta: ITimeValue,
    _sessionId?: IMediaSessionId,
  ): Promise<void> {
    this.state.currentPosition = {
      seconds: this.state.currentPosition.seconds + delta.seconds,
      nanoseconds: this.state.currentPosition.nanoseconds + delta.nanoseconds,
    };
    this.state.playbackPosition.position = this.state.currentPosition;
    this.pushState();
  }

  // --- Matter 0x09 スキップ戻し（任意） ---
  async handleSkipBackward(
    delta: ITimeValue,
    _sessionId?: IMediaSessionId,
  ): Promise<void> {
    this.state.currentPosition = {
      seconds: Math.max(0, this.state.currentPosition.seconds - delta.seconds),
      nanoseconds: 0,
    };
    this.state.playbackPosition.position = this.state.currentPosition;
    this.pushState();
  }

  // --- Matter 0x0B シーク（任意、AdvancedSeek機能が必要） ---
  async handleSeek(
    position: ITimeValue,
    _sessionId?: IMediaSessionId,
  ): Promise<void> {
    this.state.currentPosition = position;
    this.state.playbackPosition.position = position;
    this.pushState();
  }

  // --- Matter 0x0C ActivateAudioTrack（任意、AudioTracks機能が必要） ---
  async handleSetAudioTrack(
    audioTrack: ITrack,
    _sessionId?: IMediaSessionId,
  ): Promise<void> {
    // 選択したオーディオトラックをアクティブにするビジネスロジック。
  }

  // --- Matter 0x0D ActivateTextTrack（任意、TextTracks機能が必要） ---
  async handleEnableTextTrack(
    textTrack: ITrack,
    _sessionId?: IMediaSessionId,
  ): Promise<void> {
    // 選択したテキストトラックを有効にするビジネスロジック
  }

  // --- Matter 0x0E DeactivateTextTrack（任意、TextTracks機能が必要） ---
  async handleDisableTextTrack(
    _sessionId?: IMediaSessionId,
  ): Promise<void> {
    // アクティブなテキストトラックを無効にするビジネスロジック。
  }
}

export class AccountLoginWrapper {

  createAccountLoginHandler(): IAccountLoginHandlerAsync {
    return {

      // --- Matter 0x00 GetSetupPIN ---
      // コンテンツアプリは、指定されたアカウントのセットアップPINを生成します。
      handleGetSetupPin: async (accountId: string): Promise<string> => {
        console.log(`[KCP] handleGetSetupPin, accountId=${accountId}`);
        const setupPin = '12345678';
        return setupPin;
      },

      // --- Matter 0x02 ログイン ---
      // コンテンツアプリがPINを確認し、ユーザーをログインさせます。
      handleLogin: async (accountId: string, pin: string): Promise<void> => {
        console.log(`[KCP] handleLogin, accountId=${accountId}`);
        await AccountLoginWrapper.saveLoginStatus(true);
        const status = accountLoginServerComponent
          .makeStatusBuilder()
          .status(StatusType.SIGNED_IN)
          .build();
        this.accountLoginServer?.updateStatus(status);
      },

      // --- Matter 0x03 ログアウト ---
      // プレーヤーはこれを送信してユーザーのセッションを終了します。
      handleLogout: async (): Promise<void> => {
        console.log('[KCP] handleLogout');
        await AccountLoginWrapper.saveLoginStatus(false);
        const status = accountLoginServerComponent
          .makeStatusBuilder()
          .status(StatusType.SIGNED_OUT)
          .build();
        this.accountLoginServer?.updateStatus(status);
      },
    };
  }
}

const server: IMediaControlServerAsync =
  MediaControlServerComponentAsync.getOrMakeServer();

// 再生状態が変化したら、セッション状態を再構築してプッシュします。
const mediaPlayerState = new MediaPlayerState(); // MediaPlayerStateクラスから

// 例：ユーザーが再生を押す。
mediaPlayerState.playbackStatus = PlaybackStatus.PLAYING;
mediaPlayerState.playbackSpeed = 1.0;
server.updateMediaSessionStates([mediaPlayerState.getServerState()]);

// 例：ユーザーが5分のところまでシークする。
mediaPlayerState.currentPosition = { seconds: 300, nanoseconds: 0 };
mediaPlayerState.playbackPosition.position = { seconds: 300, nanoseconds: 0 };
server.updateMediaSessionStates([mediaPlayerState.getServerState()]);

// 例：ユーザーが一時停止する。
mediaPlayerState.playbackStatus = PlaybackStatus.PAUSED;
server.updateMediaSessionStates([mediaPlayerState.getServerState()]);

// 例：コンテンツの変更（次のエピソードやコンテンツランチャーが新しい映画を
// 開始するなど）
mediaPlayerState.mediaId = {
  contentId: 'episode-002',
  catalogName: 'my-catalog-v1',
};
mediaPlayerState.playbackStatus = PlaybackStatus.PLAYING;
mediaPlayerState.currentPosition = { seconds: 0, nanoseconds: 0 };
mediaPlayerState.playbackPosition.position = { seconds: 0, nanoseconds: 0 };
server.updateMediaSessionStates([mediaPlayerState.getServerState()]);

const server: IAccountLoginServerAsync =
  new AccountLoginServerComponent().getOrMakeServer();

// 例：ユーザーがサインインする。
const signedInStatus = new AccountLoginServerComponent()
  .makeStatusBuilder()
  .status(StatusType.SIGNED_IN)
  .build();
server.updateStatus(signedInStatus);

// 例：ユーザーがサインアウトする。
const signedOutStatus = new AccountLoginServerComponent()
  .makeStatusBuilder()
  .status(StatusType.SIGNED_OUT)
  .build();
server.updateStatus(signedOutStatus);