iOS पर MediaPipe फ़्रेमवर्क

MediaPipe फ़्रेमवर्क की मदद से, iOS के लिए उदाहरण के तौर पर ऐप्लिकेशन बनाने के लिए, यहां दिए गए निर्देशों का पालन करें. इन ऐप्लिकेशन के उदाहरणों के बारे में ज़्यादा जानने के लिए, iOS पर Hello World! से शुरुआत करें.

iOS के लिए उदाहरण के तौर पर ऐप्लिकेशन बनाना

पूर्वापेक्षा

1. इन निर्देशों का पालन करके, Mediapipe फ़्रेमवर्क इंस्टॉल करें.

2. Xcode इंस्टॉल करें. इसके बाद, कमांड लाइन टूल इंस्टॉल करने के लिए:

   xcode-select --install
   

3. Bazelisk इंस्टॉल करें.

   हमारा सुझाव है कि नए वर्शन पाने के लिए, Homebrew का इस्तेमाल करें.

   brew install bazelisk
   

4. Python की "six" लाइब्रेरी इंस्टॉल करें. TensorFlow के लिए यह ज़रूरी है.

   pip3 install --user six
   

5. MediaPipe के डेटा स्टोर करने की जगह को क्लोन करें.

   git clone https://github.com/google/mediapipe.git
   

बंडल आईडी का प्रीफ़िक्स सेट अप करना

सभी iOS ऐप्लिकेशन में बंडल आईडी होना चाहिए. साथ ही, आपके पास ऐसी प्रोविज़निंग प्रोफ़ाइल होनी चाहिए जिसकी मदद से, उस आईडी वाले ऐप्लिकेशन को अपने फ़ोन पर इंस्टॉल किया जा सके. MediaPipe के अलग-अलग उपयोगकर्ताओं के बीच टकराव से बचने के लिए, आपको हमारे iOS डेमो ऐप्लिकेशन के बंडल आईडी के लिए एक यूनीक प्रीफ़िक्स कॉन्फ़िगर करना होगा.

अगर आपके पास कस्टम प्रोविज़निंग प्रोफ़ाइल है, तो नीचे कस्टम प्रोविज़निंग देखें.

अगर ऐसा नहीं है, तो यूनीक प्रीफ़िक्स जनरेट करने के लिए यह निर्देश चलाएं:

python3 mediapipe/examples/ios/link_local_profiles.py

Xcode प्रोजेक्ट बनाना

इससे, Xcode में दिए गए उदाहरण के तौर पर मौजूद किसी ऐप्लिकेशन में बदलाव किया जा सकता है और उसे डीबग किया जा सकता है. इससे, आपको अपने-आप प्रोविज़न करने की सुविधा का भी इस्तेमाल करने की अनुमति मिलती है. इसके बारे में ज़्यादा जानने के लिए, अगला सेक्शन देखें.

1. हम Bazel बिल्ड कॉन्फ़िगरेशन से Xcode प्रोजेक्ट जनरेट करने के लिए, Tulsi नाम के टूल का इस्तेमाल करेंगे.

   # cd out of the mediapipe directory, then:
   git clone https://github.com/bazelbuild/tulsi.git
   cd tulsi
   # remove Xcode version from Tulsi's .bazelrc (see http://github.com/bazelbuild/tulsi#building-and-installing):
   sed -i .orig '/xcode_version/d' .bazelrc
   # build and run Tulsi:
   sh build_and_run.sh
   

   इससे, आपकी होम डायरेक्ट्री में Applications डायरेक्ट्री में Tulsi.app इंस्टॉल हो जाएगा.

2. Tulsi ऐप्लिकेशन का इस्तेमाल करके mediapipe/Mediapipe.tulsiproj खोलें.

3. Configs टैब में जाकर, MediaPipe कॉन्फ़िगरेशन चुनें. इसके बाद, नीचे दिए गए 'जनरेट करें' बटन को दबाएं. आपसे Xcode प्रोजेक्ट सेव करने के लिए जगह पूछी जाएगी. प्रोजेक्ट जनरेट होने के बाद, वह Xcode में खुल जाएगा.

   अगर आपको बंडल आईडी के बारे में गड़बड़ी का कोई मैसेज मिलता है, तो पिछला सेक्शन देखें.

प्रावधान करने की सुविधा सेट अप करना

iOS डिवाइस पर ऐप्लिकेशन इंस्टॉल करने के लिए, आपके पास प्रोविज़निंग प्रोफ़ाइल होनी चाहिए. इसके लिए, आपके पास दो विकल्प हैं:

1. अपने-आप प्रावधान की सुविधा. इससे, अपने निजी डिवाइस पर ऐप्लिकेशन बनाया और इंस्टॉल किया जा सकता है. प्रोविज़निंग प्रोफ़ाइल को Xcode मैनेज करता है. इसे अक्सर अपडेट करना पड़ता है, क्योंकि यह करीब एक हफ़्ते के लिए मान्य होती है.

2. कस्टम प्रॉविज़न. इसमें, Apple डेवलपर खाते से जुड़ी प्रोविज़निंग प्रोफ़ाइल का इस्तेमाल किया जाता है. इन प्रोफ़ाइलों की समयसीमा ज़्यादा होती है और इनसे एक से ज़्यादा डिवाइसों को टारगेट किया जा सकता है. हालांकि, इन प्रोफ़ाइलों को पाने के लिए, आपके पास Apple का पैसे चुकाकर लिया गया डेवलपर खाता होना चाहिए.

अपने-आप प्रावधान की सुविधा

1. MediaPipe के लिए Xcode प्रोजेक्ट बनाएं, जैसा कि पहले बताया गया है

2. बाईं ओर मौजूद साइडबार में प्रोजेक्ट नेविगेटर में, "Mediapipe" प्रोजेक्ट चुनें.

3. ऐप्लिकेशन के किसी टारगेट को चुनें. उदाहरण के लिए, HandTrackingGpuApp.

4. "साइनिंग और सुविधाएं" टैब चुनें.

5. "हस्ताक्षर करने की सुविधा अपने-आप मैनेज करें" को चुनें और डायलॉग बॉक्स में पुष्टि करें.

6. टीम डायलॉग मेन्यू में, "आपका नाम (निजी टीम)" चुनें.

7. आपको जिस ऐप्लिकेशन को इंस्टॉल करना है उसके लिए, यह सेट-अप एक बार करना होगा. ज़रूरत के मुताबिक, तीसरे से लेकर छठे चरण को दोहराएं.

इससे, आपके चुने गए हर ऐप्लिकेशन के लिए, प्रोविज़निंग प्रोफ़ाइलें जनरेट होती हैं. अब आपको Bazel को इनका इस्तेमाल करने के लिए कहना होगा. हमने इस प्रोसेस को आसान बनाने के लिए एक स्क्रिप्ट उपलब्ध कराई है.

1. टर्मिनल में, उस mediapipe डायरेक्ट्री पर जाएं जहां आपने रिपॉज़िटरी को क्लोन किया है.

2. यह निर्देश चलाएं:

   python3 mediapipe/examples/ios/link_local_profiles.py
   

इससे उन सभी ऐप्लिकेशन के लिए प्रोविज़निंग प्रोफ़ाइल ढूंढी और लिंक की जाएगी जिनके लिए आपने Xcode में अपने-आप प्रोविज़निंग की सुविधा चालू की है.

कस्टम प्रोविज़निंग

1. Apple से प्रोविज़निंग प्रोफ़ाइल पाएं.

1. अपनी प्रोविज़निंग प्रोफ़ाइल को mediapipe/mediapipe/provisioning_profile.mobileprovision में सिमलینک या कॉपी करें.

   cd mediapipe
   ln -s ~/Downloads/MyProvisioningProfile.mobileprovision mediapipe/provisioning_profile.mobileprovision
   

1. mediapipe/examples/ios/bundle_id.bzl खोलें और BUNDLE_ID_PREFIX को अपनी प्रोविज़निंग प्रोफ़ाइल से जुड़े प्रीफ़िक्स में बदलें.

Xcode का इस्तेमाल करके ऐप्लिकेशन बनाना और चलाना

1. Xcode प्रोजेक्ट बनाएं और पक्का करें कि आपने अपने-आप या पसंद के मुताबिक प्रावधान करने की सुविधा सेट अप की हो.

2. अब टारगेट मेन्यू में जाकर, Mediapipe फ़्रेमवर्क का कोई भी डेमो चुना जा सकता है. साथ ही, उसे सामान्य तरीके से बनाया और चलाया जा सकता है.

कमांड लाइन का इस्तेमाल करके ऐप्लिकेशन बनाना

1. पक्का करें कि आपने अपने-आप या कस्टम प्रावधान करने की सुविधा सेट अप की हो.

2. उदाहरण के लिए, MediaPipe Hands का इस्तेमाल करके:

   bazel build -c opt --config=ios_arm64 mediapipe/examples/ios/handtrackinggpu:HandTrackingGpuApp
   

   ऐप्लिकेशन को साइन करने के लिए, आपको codesign से अनुमति का अनुरोध दिख सकता है.

3. Xcode में, Devices and Simulators विंडो (command-shift-2) खोलें.

4. पक्का करें कि आपका डिवाइस कनेक्ट हो. आपको इंस्टॉल किए गए ऐप्लिकेशन की सूची दिखेगी. सूची में मौजूद "+" बटन दबाएं और Bazel की मदद से बनाई गई .ipa फ़ाइल चुनें.

5. अब अपने डिवाइस पर ऐप्लिकेशन चलाया जा सकता है.