iOS の権限と検出

iOS 14 以降では、オペレーティング システムによって新しい制限が適用され、 Cast のユーザー エクスペリエンスに影響する権限設定について学びました。また、 アプリに Cast SDK を実装します。アプリがキャスト機能を維持するには 最新バージョンの iOS を使用している場合は、これらの問題に対応するために 役立ちます。

iOS 14

iOS Cast センダーアプリを Google Cast SDK に更新する必要があります v4.6.0 以降。これらのバージョンでは、iOS 14 とその要件がサポートされています。

iOS 14 以降、ローカル ネットワーク上のデバイスをスキャンするアプリ 1 回限りの権限ダイアログで、ユーザーに検索と接続を求める 接続します。Cast プラットフォームは、ローカル ネットワークを使用して キャスト デバイスをコントロールできます。そのため、ユーザーが権限を拒否した場合、 キャスト。

ユーザー エクスペリエンスを向上させるため、SDK の UX をいくつか変更しています パフォーマンスが向上します。UX の変更により ローカル ネットワークへのアクセス許可が必要な理由をユーザーに明確に示します。 ローカル ネットワーク デバイスへのアクセスが 無効です。

v4.4.8 以前を使用する Cast SDK のバージョンでビルドされたアプリは引き続き利用できます。 Xcode 11.7 以前でビルドされている限り機能します。もし Xcode 12 以降で iOS 14 向けにビルドしている場合は、 キャスト アプリが引き続き正常に動作するように、SDK v4.6.0 以降をインストールしてください。

CocoaPods では、Cast iOS SDK v4.6.0 以降を以下の方法でダウンロードできます。 CocoaPods の設定を行うか、手動で 手動設定の手順を実施します。このリリース の基盤となる検出メカニズムが変更され、以下のことが （Xcode 12 でビルド）を使用して、ネットワーク上のキャスト デバイスを検出できます。キャスト アイコンが 常に表示されるようになりました。キャスト アイコンをタップした際、利用できるデバイスがない場合 ] ボタンをクリックすると、デバイスが動作しない理由を説明するダイアログが表示されます。 （ローカル ネットワーク アクセスを再度有効にする方法に関する情報を含む） 付与します。

Cast SDK の変更点

初めてキャストする場合

ユーザーが初めてキャストしようとしたときに、ローカル ネットワーク アクセス（LNA） ローカル ネットワーク アクセスの理由を説明するインタースティシャル ダイアログが表示される その後に、Apple 提供の iOS ローカル ネットワーク アクセス権限が続きます。 表示されます。以下のモックはこのフローを示しています。

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

iOS センダー SDK 4.6.0 以降では、ユーザーが常にキャスト アイコンを は Wi-Fi に接続されています。キャスト デバイスを利用できない場合は、 キャスト アイコンをタップするとダイアログが開き、 以下のモックに示すように、キャストを利用できない考えられる理由のヒントが表示されます。

iOS 14 でのアプリの更新

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

   CocoaPods を使用している場合は、pod update を使用して 4.8.1 SDK をプロジェクトに追加します。

   それ以外の場合は <ph type="x-smartling-placeholder"></ph> SDK を手動で pull することもできます。

   <ph type="x-smartling-placeholder">
2. NSBonjourServices を Info.plist に追加する

   Info.plist で NSBonjourServices を指定して、 iOS 14 でのローカル ネットワークの検出が可能になりました。

   _googlecast._tcp と デバイスのサービスとしての_<your-app-id>._googlecast._tcp 確認します。

   appID は receiverID です。これは、 GCKDiscoveryCriteria。

   次の NSBonjourServices 定義の例を更新します。 「ABCD1234」に置き換えるをアプリ ID に置き換えます。

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. NSLocalNetworkUsageDescription を Info.plist

   Google 検索に表示されるメッセージを プロンプトにアプリ固有の権限文字列を追加して、ネットワーク プロンプトを Info.plist ファイル Cast の説明に使用する NSLocalNetworkUsageDescription DIAL などの検出サービスが含まれます。

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} は、ローカル ネットワークを使用して Wi-Fi 上の Cast 対応デバイスを検出します
   指定します。</string>

   このメッセージは、iOS のローカル ネットワーク アクセス ダイアログの一部として、 示しています

   
4. アプリを Apple App Store に再リリースする

   4.8.1 を使用してアプリを再リリースすることもおすすめします。 必要があります。

カスタマイズ

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

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

デバイスの検出を開始するタイミングを制御できる新しいフラグを利用できます UX の特定の要素の振る舞い：

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

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

true に設定した場合は、ユーザーが 初めてGCKUICastButtonです。情報メッセージが ローカル ネットワーク権限がユーザーに付与されている理由を 必要ありません。このメッセージに続いて、iOS 14 の LNA メッセージが表示されます。 メッセージの確認応答後にキャスト デバイスの検出が開始されます。

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

false に設定した場合、デバイスの検出は フラグ GCKCastOptions::disableDiscoveryAutostart。

よくある質問

iOS 13

iOS 13 では、新しい権限要件が導入され、 Google Cast SDK を使用してアプリを操作できます。

Google Cast SDK v4.4.3 以降では、 Bluetooth® 権限は必要ありません。この API は、 サイトと新しい google-cast-sdk-no-bluetooth 個の Cocoapods。

アプリの内訳

現在使用している iOS SDK のバージョン別の内訳は次のとおりです。 次を使用:

iOS 12 以前の SDK で構築されたアプリ

• 推奨される対応。次の場合、デバイス検出のパフォーマンスが低下することがあります。 iOS 13 でも動作しますが、引き続き機能します。おすすめは Cast SDK v4.4.4 にアップグレードしてください。
• iOS 13 では、Bluetooth® の権限をアプリに付与するようユーザーに求めます。

iOS 13 SDK を使用してビルドされたアプリ

• ご対応のお願い: Cast SDK 4.4.4 に更新してください。更新しないとキャスト アイコンが表示されない場合があります。 ユーザーが位置情報の利用許可を付与しなかった場合に表示されます。Cast SDK へのアップグレード 4.4.4 は、iOS 13 で安定したキャストを実現するうえで必要です。