内容启动器集成指南

  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。');

                  // 迭代以获取数据。
                  // ...在此处

                  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": "<实体类型>",
1.2     "value": "<实体值>",
1.3     "externalIdList": [{
1.3.1          "name": "<externalId名称>",
1.3.2          "value": "<externalId值>"
        }]
      }]

...
<Movie>
  <ID>1700000725</ID>
  <Title locale="en-US">Seabound</Title>
  <Offers>
    <SubscriptionOffer>
      <LaunchDetails>
        <Quality>超高清</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>tv.streamz/movie/46720001</LaunchId>
      </LaunchDetails>
    </SubscriptionOffer>
    <FreeOffer>
      <Regions>
        <Territories>US</Territories>
      </Regions>
      <LaunchDetails>
        <Quality>标清</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>高清</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>459800033</LaunchId>
      </LaunchDetails>
    </FreeOffer>
  </Offers>
</TvShow>

<TvSeason>
  <ID>1700000234</ID>
  <Title locale="en-US">第1季</Title>
    <Offers>
     <FreeOffer>
       <Regions>
         <Territories>US</Territories>
       </Regions>
       <LaunchDetails>
         <Quality>高清</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>高清</Quality>
        <Subtitle>en-US</Subtitle>
        <LaunchId>453100008</LaunchId>
      </LaunchDetails>
    </FreeOffer>
  </Offers>
  <ShowID>1700000123</ShowID>
  <SeasonID>1700000234</SeasonID>
  <EpisodeInSeason>5</EpisodeInSeason>
</TvEpisode>
...

"parameterList": [
    {                                               // 参数 0
        "type": 13,                                 // ContentSearchParamType::VIDEO
        "value": "",                                // 内容标题不会被填充
        "externalIdList": [
            {
                "name": "catalogContentId",         // 将被弃用。 忽略此项
                "value": "tv.catalog/movie/46720000" // 目录中的ID或LaunchId
            },
            {
                "name": "amzn_id",
                "value": "tv.catalog/movie/46720000" // 目录中的ID或LaunchId
            }
        ]
    }
]

[
    {                             // 参数0
        "type": 13,               // ContentSearchParamType::VIDEO
        "value": "Seabound",      // 搜索字符串
        "externalIdList": [{
            "name": "streamz_us"   // 您的目录ID。 将被弃用。 忽略此项
            "value": "1700000725" // 目录中的ID
        },
        { 
            "name": "amzn_id"  
            "value": "1700000725" // 目录中的ID
        }
      ]
    }
]

"parameterList": [
    {
        "type": 13,
        "value": "",
        "externalIdList": [
            {
                "name": "catalogContentId",
                "value": "tv.catalog/movie/46720000"
            },
            {
                "name": "amzn_id",
                "value": "tv.catalog/movie/46720000"
            }
        ]
    }
]

// 迭代以获取数据。
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':
                    // 使用此实体ID在您的目录中查找精确内容。
                    break;
                case 'launch_url':
                    // 使用此深层链接URL直接开始播放。
                    break;
                // 在此处为您应用支持的其他externalId名称添加分支。
                default:
                    // 对于无法识别的externalId名称，执行分支操作。
                    break;
            }
        }
    }

    if (autoPlay === true) {
        console.log(`Content_Launcher_Sample: Quickplay`);
        // 使用检索到的数据在此处处理播放逻辑。
    } else {
        console.log(`Content_Launcher_Sample: 应用内搜索`);
        // 使用检索到的数据在此处处理搜索逻辑。
    }
} else {
    console.log('Content_Launcher_Sample： 获取搜索字符串时出错');
}