iOS の権限と検出

ローカル ネットワーク上のデバイスをスキャンするアプリでは、ローカル ネットワーク デバイスを検出して接続するための 1 回だけのアクセス許可ダイアログがユーザーに表示されるようになりました。Cast プラットフォームは、ローカル ネットワークを使用して Cast デバイスを検出、制御するため、ユーザーが権限を拒否すると、キャストできなくなります。

ユーザー エクスペリエンスを向上させるため、標準のデバイス選択ツールを使用しているアプリ向けに、SDK の UX を一部変更しています。これらの UX の変更により、ローカル ネットワーク アクセス権限が必要な理由と、ローカル ネットワーク デバイスへのアクセスが無効になっている場合にキャストを有効にする方法が、ユーザーにとってより明確になります。

Cast iOS SDK v4.6.0 以降は、Swift Package Manager の設定に沿って Swift Package Manager で追加するか、手動設定に沿って手動でダウンロードできます。このリリースには、Xcode 12 でビルドされたアプリがネットワーク上の Cast デバイスを検出できるように、基盤となる検出メカニズムの変更が含まれています。これで、キャスト アイコンが常に表示されるようになります。ユーザーがキャスト アイコンをタップしたときに利用可能なデバイスがない場合は、デバイスが利用できない理由を説明するダイアログが表示されます。このダイアログには、ローカル ネットワークへのアクセス権を再度有効にする方法に関する情報も含まれています。

Cast SDK の変更点

初めてキャストする場合

ユーザーが初めてキャストを試みると、ローカル ネットワーク アクセス(LNA)のインタースティシャル ダイアログが表示され、ローカル ネットワーク アクセスが必要な理由が説明されます。その後、Apple が提供する iOS のローカル ネットワーク アクセス権限プロンプトが表示されます。以下のモックは、このフローを示しています。

ローカル ネットワーク アクセス権限のフロー

キャストを利用できません

iOS 送信側 SDK 4.6.0 以降では、ユーザーが Wi-Fi に接続しているときにキャスト アイコンが常に表示されます。キャスト デバイスが利用できない場合、キャスト アイコンをタップすると、キャストが利用できない理由をユーザーに伝えるダイアログが表示されます。以下のモックをご覧ください。

キャストを使用したフローは利用できません

アプリの更新

  1. Cast iOS SDK 4.8.6 をプロジェクトに追加する

    Swift Package Manager を使用している場合は、google-cast-ios-sdk パッケージをバージョン 4.8.6 に更新します。

    それ以外の場合は、 SDK を手動でプルします。

  2. NSBonjourServices を Info.plist に追加する

    ローカル ネットワーク検出が成功するように、Info.plist で NSBonjourServices を指定します。

    デバイス検出が正しく機能するには、_googlecast._tcp と _<your-app-id>._googlecast._tcp の両方をサービスとして追加する必要があります。

    appID は receiverID です。これは、GCKDiscoveryCriteria で定義されている ID と同じです。

    次の NSBonjourServices 定義の例を更新し、「ABCD1234」を実際の appID に置き換えます。

    <key>NSBonjourServices</key>
    <array>
      <string>_googlecast._tcp</string>
      <string>_ABCD1234._googlecast._tcp</string>
    </array>
  3. NSLocalNetworkUsageDescription を Info.plist に追加します。

    ローカル ネットワーク プロンプトに表示されるメッセージをカスタマイズすることを強くおすすめします。そのためには、アプリの Info.plist ファイルに NSLocalNetworkUsageDescription 用のアプリ固有の権限文字列を追加します。たとえば、Cast の検出や、DIAL などの他の検出サービスを記述します。

    <key>NSLocalNetworkUsageDescription</key>
    <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
    network.</string>

    このメッセージは、モックに示すように、iOS のローカル ネットワーク アクセス ダイアログの一部として表示されます。

    キャストのローカル ネットワーク アクセス権限ダイアログの画像
  4. Apple App Store にアプリを再リリースする

    また、できるだけ早く 4.8.6 を使用してアプリを再リリースすることをおすすめします。

カスタマイズ

キャスト デバイスの検出の開始

デフォルトでは、ユーザーがキャスト アイコン(GCKUICastButton)を初めてタップしたときに、キャスト デバイスの検出が開始されます。ユーザーがローカル ネットワークでキャストアプリを初めて使用しようとすると、新しい LNA インタースティシャルが表示され、その後に iOS のローカル ネットワーク アクセス権限ダイアログが表示されます。

新しいフラグを使用すると、デバイス検出の開始タイミングと、UX の特定の要素の動作を制御できます。

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

デフォルト値は true です。このフラグは、GCKCastOptions::disableDiscoveryAutostart フラグが false に設定されている場合にのみ適用されます。

true に設定すると、ユーザーが初めて GCKUICastButton をタップしたときに、キャスト デバイスの検出が開始されます。ローカル ネットワーク権限が必要な理由を説明する情報メッセージがユーザーに表示されます。このメッセージの後に、iOS LNA メッセージが表示されます。 メッセージが確認されると、キャスト デバイスの検出が開始されます。

それ以降のアプリの起動では、GCKUICastButton が常に表示されます。

false に設定すると、フラグ GCKCastOptions::disableDiscoveryAutostart の値に基づいてデバイス検出が開始されます。

よくある質問

Cast SDK v4.4.8 と Xcode 12 を使用して Cast 送信側アプリを再リリースするとどうなりますか?

Apple からネットワーク マルチキャストの利用資格を取得していない場合、アプリはローカル ネットワーク上のキャスト デバイスを検出できない可能性があります。Apple は、Cast をサポートすることのみを目的としたマルチキャストの利用資格を付与しません。 Xcode 12 でビルドする場合は、Cast 4.6.0 を使用してアプリをリリースする必要があります。

Cast SDK の新しいバージョンがリリースされたら、アプリを更新するために何をする必要がありますか?

  • アプリの Info.plist を更新して、ローカル ネットワークの使用に関する説明を追加します。
  • アプリの Info.plist に NSBonjourServices を追加し、Cast の Bonjour サービス名とアプリ ID を指定します。
  • Cast SDK 4.6.0 を使用するように送信側アプリをアップグレードします。
  • アプリを Apple アプリストアに再リリースします。

4.6.0 にアップグレードした後、カスタム デバイス選択ツールにデバイスが表示されなくなったのはなぜですか?

これは、標準のデバイス選択ツールではなく、カスタムのデバイス選択ツールを使用している場合に発生する可能性がある既知の問題です。Cast SDK のバージョン 4.4.8 以前では、デバイスのスキャンは自動的に行われていました。バージョン 4.6.0 以降では、デバイス検出を開始するために、 GCKDiscoveryManager クラスの startDiscovery メソッドを明示的に呼び出す必要があります。

この変更の理由は、アプリが初めてスキャンした後に、ローカル ネットワーク アクセス(LNA)の権限プロンプトが表示されるためです。これにより、アプリのランダムな場所に権限ダイアログが表示される可能性があります。

アプリ用にカスタム デバイス選択ツールを構築するデベロッパーは、初めてデバイス スキャンを開始する前に、1 回限りのインタースティシャルを提供する必要があります。