iOS-এর জন্য Cast অ্যাপ্লিকেশন ফ্রেমওয়ার্ক (CAF) ব্যবহার করে ডেভেলপ করার জন্য সেট-আপ

Cast ফ্রেমওয়ার্ক iOS 16 এবং তার পরবর্তী যেকোনও ভার্সনে কাজ করে এবং স্ট্যাটিক ও ডায়নামিক, উভয় ফ্রেমওয়ার্কেই উপলভ্য।

সব ক্লাস ও পদ্ধতির বিবরণ জানতে Google Cast iOS API রেফারেন্স দেখুন।

মনে রাখবেন: Cast iOS SDK XCFrameworks-এর নতুন ভার্সন এখন উপলভ্য, যা Apple Silicon কম্পিউটারে ডেভেলপমেন্টের ক্ষেত্রে কাজ করে।

Xcode সেট-আপ

সতর্কতা: 'সবচেয়ে দ্রুত, অ্যাগ্রেসিভ অপ্টিমাইজেশন' করার জন্য Apple Clang - Code Generation Optimization Level ফ্ল্যাগ -Ofast-এ সেট করলে, Cast iOS SDK ব্যবহার করা অ্যাপ ক্র্যাশ করবে, কারণ অপ্টিমাইজেশনের সাথে এটি মানানসই নয়। SDK 'সবচেয়ে দ্রুত, সবচেয়ে ছোট' বিকল্পের জন্য ডিফল্ট ভ্যালু -Os সাপোর্ট করে।

1. আপনার প্রোজেক্টে Cast iOS SDK 4.8.6 যোগ করুন

   Swift প্যাকেজ ম্যানেজার ব্যবহার করলে, google-cast-ios-sdk প্যাকেজটি 4.8.6 ভার্সনে আপডেট করুন।

   অন্যথায়, ম্যানুয়ালি SDK পুল করুন।

   মনে রাখবেন: আপনার অ্যাপে কাস্টম ডিভাইস পিকার তৈরি করলে, ডিভাইস খোঁজা শুরু করতে আপনাকে GCKDiscoveryManager ক্লাসে startDiscovery পদ্ধতি স্পষ্টভাবে কল করতে হবে। Cast SDK-এর v4.5.0 রিলিজ থেকে শুরু করে ডিফল্ট হিসেবে অটোমেটিক স্ক্যানিং বন্ধ করা হয়েছে।
2. আপনার Info.plist-এ NSBonjourServices যোগ করুন

   স্থানীয় নেটওয়ার্ক ডিসকভারি সফল করতে আপনার Info.plist-এ NSBonjourServices উল্লেখ করুন।

   ডিভাইস খোঁজার ফিচার যাতে সঠিকভাবে কাজ করে তার জন্য আপনাকে পরিষেবা হিসেবে _googlecast._tcp এবং _<your-app-id>._googlecast._tcp, দুটিই যোগ করতে হবে।

   appID হল আপনার receiverID, যা আপনার GCKDiscoveryCriteria-এ সংজ্ঞায়িত একই আইডি।

   নিম্নলিখিত উদাহরণ NSBonjourServices সংজ্ঞা আপডেট করুন এবং "ABCD1234"-এর জায়গায় আপনার appID লিখুন।

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

3. আপনার Info.plist-এ NSLocalNetworkUsageDescription যোগ করুন

   আমরা আপনাকে দৃঢ়ভাবে সাজেস্ট করি যে আপনি স্থানীয় নেটওয়ার্ক প্রম্পটে দেখানো মেসেজটি কাস্টমাইজ করুন। এর জন্য আপনার অ্যাপের 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 ব্যবহার করে আপনার অ্যাপটি আবার রিলিজ করুন।

Swift প্যাকেজ ম্যানেজার সেট-আপ

Google Cast ইন্টিগ্রেট করার জন্য Swift Package Manager (SPM) ব্যবহার করার সাজেশন দেওয়া হয়। Cast iOS SDK প্যাকেজ google-cast-ios-sdk GitHub রিপোজিটরি থেকে উপলভ্য।

Xcode-এ আপনার প্রোজেক্টে Cast iOS SDK যোগ করতে:

1. Xcode-এ, ফাইল > প্যাকেজ যোগ করুন... বিকল্প বেছে নিন।
2. রিপোজিটরি URL লিখুন: https://github.com/googlecast/google-cast-ios-sdk.
3. আপনার ভার্সনিং সংক্রান্ত নিয়ম বেছে নিন। যেমন, অপ্রত্যাশিত ব্রেকিং পরিবর্তন ছাড়াই মানানসই আপডেট পেতে, ন্যূনতম 4.8.6 ভার্সন সহ পরবর্তী মেজর ভার্সন পর্যন্ত বিকল্প বেছে নিন।
4. প্যাকেজ যোগ করুন বিকল্পে ক্লিক করুন।
5. GoogleCastDynamic বা GoogleCastStatic প্রোডাক্টের মধ্যে যেকোনও একটি বেছে নিন, এবং আপনার অ্যাপ টার্গেটে এটি যোগ করুন।

সতর্কতা: আপনার টার্গেটে GoogleCastDynamic বা GoogleCastStatic প্রোডাক্টের মধ্যে শুধুমাত্র একটি যোগ করুন। একই অ্যাপে SDK-এর দুটি ভ্যারিয়েন্ট যোগ করবেন না।

ফ্রেমওয়ার্ক ভেরিয়েন্ট বেছে নিন

Cast iOS SDK প্যাকেজ দুটি প্রোডাক্ট প্রদান করে:

• GoogleCastDynamic: ডায়নামিক ফ্রেমওয়ার্ক। এতে Cast UI কম্পোনেন্টের জন্য প্রয়োজনীয় সব অ্যাসেট রিসোর্স অন্তর্ভুক্ত থাকে এবং কোনও অতিরিক্ত লিঙ্কার ফ্ল্যাগের প্রয়োজন হয় না। Mac Catalyst-এ কাজ করে এমন অ্যাপে ডায়নামিক ফ্রেমওয়ার্ক ব্যবহার করতে হবে। আরও তথ্যের জন্য, Mac Catalyst সেট-আপ দেখুন।
• GoogleCastStatic: স্ট্যাটিক ফ্রেমওয়ার্ক। এটির জন্য অতিরিক্ত সেট-আপের ধাপ প্রয়োজন যা স্ট্যাটিক ফ্রেমওয়ার্ক সেট-আপ-এ বর্ণনা করা হয়েছে।

স্ট্যাটিক ফ্রেমওয়ার্ক সেট-আপ

স্ট্যাটিক ফ্রেমওয়ার্কে রিসোর্স বান্ডেল অন্তর্ভুক্ত করা যাবে না। এর ফলে, Swift প্যাকেজ ম্যানেজার Cast UI কম্পোনেন্টের (যেমন, UI ছবি, স্টোরিবোর্ড ও লোকালাইজেশন ফাইল) জন্য প্রয়োজনীয় অ্যাসেট রিসোর্স GoogleCastStatic প্রোডাক্টের সাথে অটোমেটিক বান্ডেল করতে পারে না। আপনার টার্গেটে GoogleCastStatic যোগ করলে, নিম্নলিখিত ধাপগুলি সম্পূর্ণ করুন:

1. আপনার Xcode প্রোজেক্টে, -ObjC -lc++ ফ্ল্যাগটি বিল্ড সেটিংস > অন্যান্য লিঙ্কার ফ্ল্যাগ-এ যোগ করুন।
2. আপনার অ্যাপ Cast UI কম্পোনেন্ট ব্যবহার করলে, আপনার প্রোজেক্টে ম্যানুয়ালি অ্যাসেট বান্ডেল যোগ করুন:
   1. ডাউনলোড থেকে স্ট্যাটিক লাইব্রেরি ডাউনলোড করুন। স্ট্যাটিক লাইব্রেরির ভার্সন আপনার যোগ করা প্যাকেজের ভার্সনের সাথে মিলছে কিনা তা ভালোভাবে দেখুন।
   2. আনজিপ করা ডিরেক্টরিতে Resources ফোল্ডারটি খুঁজে বের করুন এবং .bundle ফাইলগুলি আপনার Xcode প্রোজেক্টে টেনে আনুন। 'প্রয়োজন হলে সব আইটেম কপি করুন' বিকল্পে টিক চিহ্ন দিন এবং সব টার্গেটে যোগ করুন।

মনে রাখবেন: আপনি google-cast-ios-sdk প্যাকেজ নতুন ভার্সনে আপডেট করলে, আপনার প্রোজেক্টের অ্যাসেট বান্ডেল একই ভার্সনের স্ট্যাটিক লাইব্রেরির বান্ডেল দিয়ে পরিবর্তন করুন।

CocoaPods সেট-আপ

সতর্কতা: CocoaPods-এর জন্য সহায়তা বন্ধ করা হয়েছে। CocoaPods-এ প্রকাশিত শেষ আপডেট হল ভার্সন 4.8.6। Swift প্যাকেজ ম্যানেজার ব্যবহার করে পরবর্তী আপডেট উপলভ্য হবে এবং সরাসরি ডাউনলোড করার জন্য উপলভ্য থাকবে।

ম্যানুয়াল সেট-আপ

Swift প্যাকেজ ম্যানেজার ব্যবহার না করে আপনার প্রোজেক্টে Cast iOS SDK যোগ করার জন্য নিম্নলিখিত নির্দেশাবলী দেওয়া হল:

গুরুত্বপূর্ণ পয়েন্ট: ভার্সন 4.8.4 থেকে শুরু করে, আপনি যদি Protobuf-এর উপর নির্ভর করে এমন অন্য কোনও লাইব্রেরি ব্যবহার করেন (যেমন Firebase), তাহলে স্ট্যাটিক লাইব্রেরি ব্যবহার করলে অ্যাপের সাইজ বেড়ে যাবে।

Protobuf-এর সাথে সম্ভাব্য ভার্সন কম্প্যাটিবিলিটি সংক্রান্ত সমস্যা এড়াতে, আমরা আপনাকে স্ট্যাটিক লাইব্রেরি ব্যবহার করার সাজেশন দিই। তবে, সাইজের পার্থক্য যদি আপনার পরিস্থিতির জন্য চিন্তার কারণ হয়, তাহলে ডায়নামিক লাইব্রেরি ডাউনলোড করুন।

ডাউনলোড

নিচে থেকে উপযুক্ত লাইব্রেরি ডাউনলোড করার পরে, আপনার প্রোজেক্টে ফ্রেমওয়ার্ক যোগ করতে সেট-আপ করার ধাপ অনুসরণ করুন।

Cast iOS Sender SDK 4.8.6 লাইব্রেরি:

স্ট্যাটিক ডায়নামিক

সেট-আপ করার ধাপ

লাইব্রেরি ইনস্টল করতে:

1. আপনার প্রোজেক্টের জন্য উপযুক্ত SDK ডাউনলোড ও এক্সট্র্যাক্ট করুন।
2. ডায়নামিক GoogleCastSDK লাইব্রেরি সেট-আপ করুন:
3. আনজিপ করা .xcframework ফাইলটি টেনে নিয়ে Xcode প্রোজেক্ট নেভিগেটরে আপনার মূল প্রোজেক্টে রাখুন। 'প্রয়োজন হলে সব আইটেম কপি করুন' বিকল্পটি চেক করুন এবং সব টার্গেটে যোগ করুন।
4. আপনার Xcode টার্গেটে, General ট্যাবের অধীনে, GoogleCast.xcframework-এর জন্য Embed and Sign বেছে নিন।

আপনি ডায়নামিক লাইব্রেরি সেট-আপ করলে, আগের ধাপের সাথে এইসব ধাপও অনুসরণ করুন:

1. GoogleCastSDK-এর বর্তমান ভার্সন থাকলে তা সরিয়ে দিন।
2. Protobuf GitHub রেপো-তে দেওয়া নির্দেশাবলী অনুসরণ করে Protobuf লাইব্রেরি v3.13 বা তার পরবর্তী ভার্সন যোগ করুন।

আপনি স্ট্যাটিক লাইব্রেরি সেট-আপ করলে, আগের ধাপগুলি ছাড়াও এইসব ধাপ অনুসরণ করুন:

1. আপনার Xcode প্রোজেক্টে, -ObjC -lc++ ফ্ল্যাগটি বিল্ড সেটিংস > অন্যান্য লিঙ্কার ফ্ল্যাগ-এ যোগ করুন।
2. আনজিপ করা ডিরেক্টরিতে রিসোর্স ফোল্ডারটি খুঁজুন এবং আপনার প্রোজেক্টে আগে যোগ করা GoogleCast.xcframework-এর পাশে সব .bundle ফাইল টেনে আনুন। 'প্রয়োজন হলে সব আইটেম কপি করুন' বিকল্পে টিক চিহ্ন দিন এবং সব টার্গেটে যোগ করুন।

Mac Catalyst সেট-আপ

Mac Catalyst-এ কাজ করে এমন অ্যাপের জন্য Cast SDK-এর ডায়নামিক লাইব্রেরি ব্যবহার করুন। আপনার প্রোজেক্টে ফ্রেমওয়ার্ক যোগ করতে ম্যানুয়াল সেট-আপ প্রসেস অনুসরণ করুন। তারপর, Apple ডকুমেন্টেশনে উল্লেখ করা Mac টার্গেট থেকে শর্তসাপেক্ষে Cast SDK বাদ দিন। স্ট্যাটিক লাইব্রেরি iOS আর্কিটেকচারের জন্য প্রি-কম্পাইল করা হয়, যার ফলে Mac টার্গেটের জন্য বিল্ড করার সময় লিঙ্কার সমস্যা হয়।