コンテンツランチャー統合ガイド

import { useComponentInstance, IComponentInstance } from '@amazon-devices/react-native-kepler';

export const App = () => {
    const componentInstance: IComponentInstance = useComponentInstance();

    useEffect(() => {
        const factory = new ContentLauncherServerComponent();

        const contentLauncherHandler: IContentLauncherHandler = {
            async handleLaunchContent(
                contentSearch: IContentSearch,
                autoPlay: boolean,
                _optionalFields: ILaunchContentOptionalFields,
            ): Promise<ILauncherResponse> {
                console.log('Content_Launcher_Sample: handleLaunchContent invoked.');

                // 繰り返し処理して..
                //..ここでデータを取得します

                const launcherResponse = factory
                    .makeLauncherResponseBuilder()
                    .contentLauncherStatus(ContentLauncherStatusType.SUCCESS)
                    .build();

                return Promise.resolve(launcherResponse);
            },
        };

        const contentLauncherServer = factory.getOrMakeServer();
        contentLauncherServer.setHandlerForComponent(contentLauncherHandler, componentInstance);

        return () => {};
    }, []);

    // ここでプロバイダーアプリのユーザーインターフェイスを作成します。
};

1     "parameterList": [{
1.1     "type": "<entity type>",
1.2     "value": "<entity value>",
1.3     "externalIdList": [{
1.3.1          "name": "<externalId name>",
1.3.2          "value": "<externalId value>"
        }]
      }]

...
<Movie>
  <ID>1700000725</ID>
  <Title locale="en-US">Seabound</Title>
  <Offers>
    <SubscriptionOffer>
      <LaunchDetails>
        <Quality>UHD</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>tv.streamz/movie/46720001</LaunchId>
      </LaunchDetails>
    </SubscriptionOffer>
    <FreeOffer>
      <Regions>
        <Territories>US</Territories>
      </Regions>
      <LaunchDetails>
        <Quality>SD</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>tv.streamz/movie/467200002</LaunchId>
      </LaunchDetails>
    </FreeOffer>
  </Offers>
</Movie>

<TvShow>
  <ID>1700000123</ID>
  <Title locale="en-US">The SeaShow: The Real Story</Title>
  <Offers>
    <FreeOffer>
      <Regions>
        <Territories>US</Territories>
      </Regions>
      <LaunchDetails>
        <Quality>HD</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>459800033</LaunchId>
      </LaunchDetails>
    </FreeOffer>
  </Offers>
</TvShow>

<TvSeason>
  <ID>1700000234</ID>
  <Title locale="en-US">Season 1</Title>
    <Offers>
     <FreeOffer>
       <Regions>
         <Territories>US</Territories>
       </Regions>
       <LaunchDetails>
         <Quality>HD</Quality>
         <Subtitle>en-US</Subtitle>
         <LaunchId>453200012</LaunchId>
        </LaunchDetails>
     </FreeOffer>
   </Offers>
   <ShowID>1700000123</ShowID>
   <SeasonInShow>2</SeasonInShow>
</TvSeason>

<TvEpisode>
  <ID>1700000825</ID>
  <Title locale="en-US">The Seashow. Story Starts</Title>
  <Offers>
    <FreeOffer>
      <Regions>
        <Territories>US</Territories>
      </Regions>
      <LaunchDetails>
        <Quality>HD</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>453100008</LaunchId>
      </LaunchDetails>
    </FreeOffer>
  </Offers>
  <ShowID>1700000123</ShowID>
  <SeasonID>1700000234</SeasonID>
  <EpisodeInSeason>5</EpisodeInSeason>
</TvEpisode>
...

"parameterList": [
    {                                               // parameter 0
        "type": 13,                                 // ContentSearchParamType::VIDEO
        "value": "",                                // Content title won't be populated
        "externalIdList": [
            {
                "name": "catalogContentId",         // To be deprecated. Ignore this
                "value": "tv.catalog/movie/46720000" // ID or LaunchId from catalog
            },
            {
                "name": "amzn_id",
                "value": "tv.catalog/movie/46720000" // ID or LaunchId from catalog
            }
        ]
    }
]

[
    {                             // パラメーター0。
        "type": 13,               // ContentSearchParamType::VIDEO
        "value": "Seabound",      // 検索文字列。
        "externalIdList": [{
            "name": "streamz_us"  // カタログID。 廃止される予定です。 これは無視してください。
            "value": "1700000725" // カタログからのID。
        },
        { 
            "name": "amzn_id"  
            "value": "1700000725" // カタログからのID。
        }
      ]
    }
]

[
  {                // パラメーター0。
    "type": 13,    // ContentSearchParamType::VIDEO
    "value": "The SeaShow: The Real Story シーズン2 エピソード5", 

    "externalIdList": [{
       "name": "streamz_us", // 廃止される予定です。これは無視してください。
       "value": "1700000123" // カタログからの番組のID。
     },
     {
      "name": "amzn_id",
      "value": "1700000123" // カタログからの番組のID。
    }]
  },
  {                // パラメーター1。
    "type": 14,    // ContentSearchParamType::SEASON
    "value": "2",  // カタログ内のシーズン番号。
    "externalIdList": []
  },
  {               // パラメーター2。
    "type": 15,   // ContentSearchParamType::EPISODE
    "value": "5", // カタログ内のエピソード番号。
    "externalIdList": []
  }
]

// Iterate to fetch data.
const searchParameters = contentSearch.getParameterList();
if (searchParameters.length > 0) {
    for (const searchParameter of searchParameters) {
        const paramType = searchParameter.getParamType();
        const searchString = searchParameter.getValue();

        const additionalInfoList = searchParameter.getExternalIdList();
        for (const additionalInfo of additionalInfoList) {
            const searchName = additionalInfo.getName();
            const entityID = additionalInfo.getValue();

            switch (searchName) {
                case 'amzn_id':
                    // Use this entity ID to look up exact content in your catalog.
                    break;
                case 'launch_url':
                    // Use this deep-link URL to start playback directly.
                    break;
                // Add cases here for any additional externalId names your app supports.
                default:
                    // Fall through for unrecognized externalId names.
                    break;
            }
        }
    }

    if (autoPlay === true) {
        console.log(`Content_Launcher_Sample: Quickplay`);
        // Handle play logic here using the data retrieved.
    } else {
        console.log(`Content_Launcher_Sample: In-App search`);
        // Handle search logic here using the data retrieved.
    }
} else {
    console.log('Content_Launcher_Sample: Error fetching search string');
}