O framework do Cast oferece suporte ao iOS 14 e versões mais recentes e vem em frameworks estáticos e dinâmicos.
Consulte a Referência da API Google Cast para iOS para ver descrições de todas as classes e métodos.
Configuração do Xcode
iOS 14
-
Adicionar o SDK do Cast para iOS 4.8.1 ao projeto
Se estiver usando CocoaPods, use
pod update
para adicionar o SDK 4.8.1 ao seu projeto.Caso contrário, extraia o SDK manualmente.
-
Adicione
NSBonjourServices
ao seuInfo.plist
Especifique
NSBonjourServices
noInfo.plist
para que a descoberta de rede local funcione no iOS 14.É necessário adicionar
_googlecast._tcp
e_<your-app-id>._googlecast._tcp
como serviços para que a descoberta de dispositivos funcione corretamente.O appID é o receiverID, que é o mesmo ID definido no
GCKDiscoveryCriteria
.Atualize o exemplo de definição de
NSBonjourServices
a seguir e substitua "ABCD1234" pelo seu 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.8.1 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. For integration, use the
google-cast-sdk
CocoaPods.
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, '14.0'
def target_pods
pod 'google-cast-sdk'
end
target 'CastVideos-objc' do
target_pods
end
target 'CastVideos-swift' do
target_pods
end
Para o projeto, especifique um intervalo para os pods a fim de evitar alterações interruptivas inesperadas, conforme detalhado no guia de pods.
Neste snippet, são permitidas a versão 4.8.1 e as versões até a próxima versão principal (major.minor.patch):
pod 'google-cast-sdk', '~> 4.8.1'
Por exemplo, '~> 1.6.7' incluiria todas as versões de 1.6.7 e até, mas não incluindo, a versão 2.0.0.
Configuração manual
As instruções a seguir servem para adicionar o SDK do Cast para iOS ao projeto sem usar o CocoaPods:
Downloads
Depois de fazer o download da biblioteca apropriada abaixo, siga as etapas de configuração para adicionar o framework ao seu projeto.
Transmita bibliotecas do SDK Sender do iOS 4.8.1:
Etapas da configuração
Para instalar a biblioteca:
- Faça o download e extraia o SDK adequado para seu projeto.
- Configure a biblioteca dinâmica do GoogleCastSDK:
-
Arraste o
.xcframework
descompactado para seu projeto principal no navegador de projetos do Xcode (não para o projeto de pods, se você tiver um). Marque "Copiar todos os itens, se necessário" e adicione a todos os destinos. -
No destino do Xcode, na guia
General
, selecioneEmbed and Sign
paraGoogleCast.xcframework
.
Se você estiver configurando a biblioteca static, siga estas etapas, além das anteriores:
- Configure a biblioteca Protobuf com a versão mínima v3.13.
- Se o projeto usa CocoaPods:
-
Abra seu
Podfile
e remova ogoogle-cast-sdk
, se houver:pod 'google-cast-sdk'
-
Adicione a biblioteca
Protobuf
se ela não estiver presente:pod 'Protobuf', '3.13'
-
Execute
pod install
na pasta raiz do seu projeto. - Se o projeto não estiver usando CocoaPods:
-
Remove a versão atual de
GoogleCastSDK
, se houver. - Adicione a biblioteca Protobuf v3.13 ou posterior seguindo as instruções encontradas no repositório Protobuf do GitHub (em inglês).
-
No seu projeto do Xcode, adicione as sinalizações
-ObjC -lc++
a Build Settings > Other Linker Flags. -
Localize a pasta "Resources" no diretório descompactado e
arraste
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
eMaterialDialogs.bundle
para o projeto ao lado doGoogleCast.xcframework
que você adicionou anteriormente. Marque "Copy all items if needed" e adicione a todos os destinos.
Configuração do Mac Catalyst
Para apps compatíveis com o Mac Catalyst, use a biblioteca dinâmica do SDK do Cast. Siga o processo de configuração manual para adicionar o framework ao projeto. Em seguida, exclua condicionalmente o SDK do Cast do destino do Mac, conforme mencionado na documentação da Apple. As bibliotecas estáticas são pré-compiladas para a arquitetura do iOS, o que causa um erro do vinculador ao criar para o destino do Mac.