キャスト フレームワークは iOS 12 以降に対応しており、静的フレームワークと動的フレームワークの両方を備えています。
すべてのクラスとメソッドの詳細については、Google Cast iOS API リファレンスをご覧ください。
新世代のキャスト デバイスは iOS のゲストモードをサポートしていますが、古い世代のデバイスはゲストモードをサポートしていません。詳しくは、ゲストモード - サポートされているキャスト デバイスをご覧ください。
Xcode の設定
iOS 14
-
Cast iOS SDK 4.7.0 をプロジェクトに追加する
CocoaPods を使用している場合は、
pod update
を使用して 4.7.0 SDK をプロジェクトに追加します。それ以外の場合は、SDK を手動で取得します。
-
NSBonjourServices
をInfo.plist
に追加するiOS 14 でローカル ネットワーク ディスカバリが成功するように、
Info.plist
にNSBonjourServices
を指定します。デバイス検出を正しく動作させるには、
_googlecast._tcp
と_<your-app-id>._googlecast._tcp
の両方をサービスとして追加する必要があります。appID はレシーバー ID で、
GCKDiscoveryCriteria
で定義されているものと同じ ID です。次の
NSBonjourServices
定義の例を更新し、「ABCD1234」を appID に置き換えます。 -
Add
NSLocalNetworkUsageDescription
to yourInfo.plist
We strongly recommend that you customize the message shown in the Local Network prompt by adding an app-specific permission string in your app's
Info.plist
file for theNSLocalNetworkUsageDescription
such as to describe Cast discovery and other discovery services, like DIAL.This message will appear as part of the iOS Local Network Access dialog as shown in the mock.
-
Re-release your app to the Apple App Store
We recommend you also re-release your app using 4.7.0 as soon as possible.
iOS 13
iOS 12
Ensure that the Access WiFi Information switch in the Capabilities section of the target is set to "On".
Additionally, your provisioning profile will need to support the Access WiFi Information capability. This can be added in the Apple Developer Portal.
CocoaPods setup
The recommended way of integrating Google Cast is using CocoaPods.
The google-cast-sdk and
google-cast-sdk-no-bluetooth
CocoaPods are available for download.
Use the google-cast-sdk-no-bluetooth
if your app does not require
guest mode or you do not wish to require Bluetooth®
permission.
To get started, follow the getting started guide.
Once CocoaPods is set up, follow the
using CocoaPods guide
to get your Podfile
created and your project ready to use with the Google Cast
SDK.
Here's an example of how to add the google-cast-sdk
CocoaPod to your
Podfile
:
use_frameworks!
platform :ios, '12.0'
def target_pods
pod 'google-cast-sdk'
end
target 'CastVideos-objc' do
target_pods
end
target 'CastVideos-swift' do
target_pods
end
google-cast-sdk-no-bluetooth
CocoaPod を Podfile
に追加する方法の例を次に示します。
use_frameworks!
platform :ios, '12.0'
def target_pods
pod 'google-cast-sdk-no-bluetooth'
end
target 'CastVideos-objc' do
target_pods
end
target 'CastVideos-swift' do
target_pods
end
プロジェクトでは、podfile ガイドで説明されているように、予期しない互換性を破る変更を防ぐために Pod の範囲を指定する必要があります。
このスニペットでは、バージョン 4.7.0 と、次のメジャー バージョン(major.minor.patch)までのバージョンが許可されています。
pod 'google-cast-sdk', '~> 4.7.0'
たとえば、「~> 1.6.7」はバージョン 1.6.7 から 2.0.0 までのすべてのバージョンを含みます。
手動設定
CocoaPods を使用せずに Cast iOS SDK をプロジェクトに追加する手順は以下のとおりです。
ダウンロード
以下の適切なライブラリをダウンロードしたら、設定手順に従ってフレームワークをプロジェクトに追加します。XCFrameworks の設定要件は、従来のユニバーサル フレームワークと同じです。
アプリがこの機能を必要としない、または iOS 13 で導入された Bluetooth® の権限を必要としない状況向けに、ゲストモードのないライブラリが提供されています。詳しくは、iOS 13 の変更点に関するドキュメントをご覧ください。
ユニバーサル フレームワーク
Cast iOS Sender SDK 4.7.0 ライブラリ:
XCFramework(ベータ版)
バージョン 4.7.1 以降の Cast iOS SDK は XCFrameworks をサポートしているため、Apple M1 コンピュータでの開発と、M1 iOS Simulator を使用したデバッグが可能です。
これらのライブラリは現在ベータ版です。問題が発生した場合は、Cast SDK Issue Tracker にご報告ください。
Cast iOS Sender SDK XCFramework 4.7.1 ライブラリ:
ゲストモードありの静的 XCFramework ゲストモードなしの静的 XCFramework
ゲストモードありの Dynamic XCFramework ゲストモードなしの動的 XCFramework
設定の手順
静的ライブラリのいずれかをインストールするには:
- プロジェクトに適した静的 SDK をダウンロードして解凍します。
- 最小バージョン v3.13 で Protobuf ライブラリを設定します。
- プロジェクトで CocoaPods を使用している場合:
-
Podfile
を開き、google-cast-sdk
(存在する場合)を削除します。pod 'google-cast-sdk'
-
Protobuf
ライブラリが存在しない場合は追加します。pod 'Protobuf', '3.13'
-
プロジェクトのルートフォルダで
pod install
を実行します。 - プロジェクトで CocoaPods を使用していない場合:
-
GoogleCastSDK
の最新バージョンが存在する場合は、削除します。 - Protobuf GitHub リポジトリの手順に沿って、Protobuf ライブラリ v3.13 以降を追加します。
-
解凍した
.framework
または.xcframework
を Xcode プロジェクト ナビゲータのメイン プロジェクト(Pod プロジェクトがある場合は、Pod プロジェクト内にない)にドラッグします。[必要に応じてすべてのアイテムをコピー] をオンにして、すべてのターゲットに追加します。 -
Xcode プロジェクトで、
-ObjC -lc++
フラグを [Build Settings] > [Other Linker Flags] に追加します。 -
プロジェクトで
GoogleCast.framework
またはGoogleCast.xcframework
を右クリックし、[Show In Finder] を選択します。 -
以前に追加した
GoogleCast.framework
またはGoogleCast.xcframework
の横にあるプロジェクトにGoogleCastCoreResources.bundle
とGoogleCastUIResources.bundle
をドラッグし、[必要に応じてすべてのアイテムをコピーする] チェックボックスをオンにして、すべてのターゲットに追加します。
いずれかの動的ライブラリをインストールするには:
- プロジェクトに適した動的 SDK をダウンロードして解凍します。
- 動的 GoogleCastSDK ライブラリをセットアップします。
- プロジェクトで CocoaPods を使用している場合:
-
Podfile
を開き、以下を削除します。pod 'google-cast-sdk'
-
プロジェクトのルートフォルダで
pod install
を実行します。 - プロジェクトで CocoaPods を使用していない場合は、現在の Google Cast ライブラリを削除します。
-
解凍した
.framework
または.xcframework
を Xcode プロジェクト ナビゲータのメイン プロジェクト(Pod プロジェクトがある場合は、Pod プロジェクト内にない)にドラッグします。[必要に応じてすべてのアイテムをコピー] をオンにして、すべてのターゲットに追加します。 -
Xcode ターゲットの [
General
] タブで、GoogleCast.framework
またはGoogleCast.xcframework
にEmbed and Sign
を選択します。
Mac Catalyst の設定
Mac Catalyst をサポートするアプリの場合、Cast SDK の動的ライブラリを使用します。手動設定プロセスに沿って、プロジェクトにフレームワークを追加します。Apple のドキュメントに記載されているように、条件付きで Cast SDK を Mac ターゲットから除外します。静的ライブラリは iOS アーキテクチャ用にプリコンパイルされているため、Mac のターゲットに対するビルド時にリンカーエラーが発生します。
アプリを App Store に公開する
アプリを App Store に公開する前に、シェル スクリプト strip_unused_archs.sh
を実行して、未使用のアーキテクチャを App Bundle から削除する必要があります。このスクリプトは iOS 用の Cast SDK に含まれています。