فریم ورک Cast از iOS 14 به بعد پشتیبانی می کند و در هر دو چارچوب استاتیک و پویا عرضه می شود.
برای توضیحات همه کلاسها و روشها به مرجع Google Cast iOS API مراجعه کنید.
راه اندازی Xcode
iOS 14
- Cast iOS SDK 4.8.1 را به پروژه خود اضافه کنید
اگر از CocoaPods استفاده می کنید، از
pod update
استفاده کنید تا SDK 4.8.1 را به پروژه خود اضافه کنید.در غیر این صورت، SDK را به صورت دستی بکشید .
-
NSBonjourServices
بهInfo.plist
خود اضافه کنیدNSBonjourServices
درInfo.plist
خود مشخص کنید تا امکان کشف شبکه محلی در iOS 14 با موفقیت انجام شود.شما باید هم
_googlecast._tcp
و هم_<your-app-id>._googlecast._tcp
را به عنوان سرویس اضافه کنید تا کاوش دستگاه به درستی کار کند.appID همان شناسه گیرنده شما است که در
GCKDiscoveryCriteria
شما تعریف شده است.تعریف مثال زیر
NSBonjourServices
را به روز کنید و "ABCD1234" را با شناسه برنامه خود جایگزین کنید. -
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
برای پروژه خود، باید محدوده ای را برای پادهای خود تعیین کنید تا از تغییرات شکسته غیرمنتظره همانطور که در راهنمای پادفایل توضیح داده شده است جلوگیری کنید.
در این قطعه، نسخه 4.8.1 و نسخه های تا نسخه اصلی بعدی (major.minor.patch) مجاز هستند:
pod 'google-cast-sdk', '~> 4.8.1'
برای مثال، «~> 1.6.7» شامل همه نسخهها از 1.6.7 به بالا است، اما شامل نسخه 2.0.0 نمیشود.
راه اندازی دستی
دستورالعمل های زیر برای افزودن Cast iOS SDK به پروژه خود بدون استفاده از CocoaPods است:
دانلودها
پس از دانلود کتابخانه مناسب زیر، مراحل راه اندازی را دنبال کنید تا چارچوب را به پروژه خود اضافه کنید.
کتابخانههای iOS Sender SDK 4.8.1 Cast:
مراحل راه اندازی
برای نصب کتابخانه:
- SDK مناسب برای پروژه خود را دانلود و استخراج کنید.
- کتابخانه پویا GoogleCastSDK را تنظیم کنید:
- xcframework
.xcframework
خارج شده را به پروژه اصلی خود در ناوبری پروژه Xcode بکشید (اگر دارید به پروژه Pods نیستید). "در صورت نیاز همه موارد را کپی کنید" را علامت بزنید و به همه اهداف اضافه کنید. - در هدف Xcode خود، در زیر برگه
General
،Embed and Sign
forGoogleCast.xcframework
را انتخاب کنید.
اگر کتابخانه ایستا را راه اندازی می کنید، این مراحل را علاوه بر مراحل قبلی دنبال کنید:
- کتابخانه Protobuf را با حداقل نسخه 3.13 راه اندازی کنید.
- اگر پروژه شما از CocoaPods استفاده می کند:
-
Podfile
خود را باز کنید وgoogle-cast-sdk
در صورت وجود حذف کنید:pod 'google-cast-sdk'
- اگر کتابخانه
Protobuf
وجود ندارد اضافه کنید:pod 'Protobuf', '3.13'
-
pod install
در پوشه ریشه پروژه خود اجرا کنید. - اگر پروژه شما از CocoaPods استفاده نمی کند:
- در صورت وجود، نسخه فعلی
GoogleCastSDK
را حذف کنید. - به دنبال دستورالعملهای موجود در مخزن Protobuf GitHub ، کتابخانه Protobuf نسخه 3.13 یا بالاتر را اضافه کنید.
- در پروژه Xcode خود، پرچمها
-ObjC -lc++
را به Build Settings > Other Linker Flags اضافه کنید. - پوشه Resources را در دایرکتوری زیپ نشده پیدا کنید و
GoogleCastCoreResources.bundle
،GoogleCastUIResources.bundle
وMaterialDialogs.bundle
را در پروژه خود در کنارGoogleCast.xcframework
که قبلاً اضافه کرده اید، بکشید. "در صورت نیاز همه موارد را کپی کنید" را علامت بزنید و به همه اهداف اضافه کنید.
راه اندازی Mac Catalyst
برای برنامههایی که از Mac Catalyst پشتیبانی میکنند، از کتابخانه پویا Cast SDK استفاده کنید. فرآیند راه اندازی دستی را برای اضافه کردن چارچوب به پروژه خود دنبال کنید. سپس به طور مشروط Cast SDK را از هدف Mac حذف کنید، همانطور که در اسناد اپل ذکر شده است. کتابخانه های ایستا برای معماری iOS از قبل کامپایل شده اند، که باعث ایجاد خطای پیوند دهنده هنگام ساختن در برابر هدف مک می شود.