IPlayerClientFactory

Keplerプレーヤークライアントインスタンスを提供するコンポーネント。

メソッド

getOrMakeClient()

getOrMakeClient(serviceComponentId): IPlayerClient

Keplerプレーヤークライアントのインスタンスを取得または作成します。

パラメーター

serviceComponentId

string

サービス中の再生セッションをホストするためにアプリによって起動されるサービスコンポーネントのコンポーネントIDです。例：serviceComponentID: "com.x.y.z.headlessservice"

戻り値

IPlayerClient

Keplerプレーヤークライアントインスタンス。

例

// 使用例

import {PlayerClientFactory, IPlayerClient} from '@amazon-devices/kepler-player-client';
import {PackageInfo, PackageManager} from '@amazon-devices/package-manager-lib';

const parseClientPackageManifest = async (): Promise<string> => {
  try {
    const selfPackageInfo: PackageInfo =
      await PackageManager.getSelfPackageInfo();
    for (const component of selfPackageInfo.components) {
      if (component.type === 'service') {
        return component.id;
      }
    }
    return '';
  } catch (error) {
    console.warn(
      `Interactive: パッケージマネージャーから情報を取得できません, ${error.message}`,
    );
    return '';
  }
};

const playerClientRef = useRef<IPlayerClient | null>(null);
const playerClientFactory = new PlayerClientFactory();
let serviceComponentId: string | undefined =
  await this.parseClientPackageManifest();

if (playerClientRef.current == null) {
  playerClientRef.current =
    playerClientFactory.getOrMakeClient(serviceComponentId);
}

Last updated: 2025年10月2日