इस पेज का अनुवाद Cloud Translation API से किया गया है.

ऐप्पल प्लेटफॉर्म पर फायरबेस ऑथ और फंक्शन्स का उपयोग करके क्लाउड विजन के साथ छवियों को सुरक्षित रूप से लेबल करें

अपने ऐप से Google क्लाउड एपीआई को कॉल करने के लिए, आपको एक इंटरमीडिएट रेस्ट एपीआई बनाना होगा जो प्राधिकरण को संभालता है और एपीआई कुंजियों जैसे गुप्त मूल्यों की सुरक्षा करता है। इसके बाद आपको इस इंटरमीडिएट सेवा को प्रमाणित करने और उससे संचार करने के लिए अपने मोबाइल ऐप में कोड लिखना होगा।

इस REST API को बनाने का एक तरीका फायरबेस ऑथेंटिकेशन एंड फंक्शंस का उपयोग करना है, जो आपको Google क्लाउड एपीआई के लिए एक प्रबंधित, सर्वर रहित गेटवे देता है जो प्रमाणीकरण को संभालता है और पूर्व-निर्मित एसडीके के साथ आपके मोबाइल ऐप से कॉल किया जा सकता है।

यह मार्गदर्शिका दर्शाती है कि अपने ऐप से क्लाउड विज़न API को कॉल करने के लिए इस तकनीक का उपयोग कैसे करें। यह विधि सभी प्रमाणित उपयोगकर्ताओं को आपके क्लाउड प्रोजेक्ट के माध्यम से क्लाउड विज़न बिल की गई सेवाओं तक पहुँचने की अनुमति देगी, इसलिए आगे बढ़ने से पहले विचार करें कि क्या यह प्रमाणीकरण तंत्र आपके उपयोग के मामले के लिए पर्याप्त है।

शुरू करने से पहले

अपना प्रोजेक्ट कॉन्फ़िगर करें

यदि आपने पहले से ही अपने ऐप में Firebase नहीं जोड़ा है, तो आरंभ करने की मार्गदर्शिका में दिए गए चरणों का पालन करके ऐसा करें।

फायरबेस निर्भरताओं को स्थापित और प्रबंधित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

Xcode में, अपने ऐप प्रोजेक्ट को खोलने के साथ, File > Add Packages पर नेविगेट करें।
संकेत दिए जाने पर, Firebase Apple प्लेटफ़ॉर्म SDK रिपॉजिटरी जोड़ें:

  https://github.com/firebase/firebase-ios-sdk

फायरबेस एमएल लाइब्रेरी चुनें।
समाप्त होने पर, Xcode स्वचालित रूप से पृष्ठभूमि में आपकी निर्भरताओं को हल करना और डाउनलोड करना शुरू कर देगा।

अगला, कुछ इन-ऐप सेटअप करें:

अपने ऐप में, फायरबेस आयात करें:
तीव्र
```
import FirebaseMLModelDownloader
```
उद्देश्य सी
```
@import FirebaseMLModelDownloader;
```

कुछ और कॉन्फ़िगरेशन चरण, और हम जाने के लिए तैयार हैं:

यदि आपने अपने प्रोजेक्ट के लिए क्लाउड-आधारित API को पहले से सक्षम नहीं किया है, तो अभी ऐसा करें:
1. Firebase कंसोल का Firebase ML APIs पेज खोलें।
2. यदि आपने अपने प्रोजेक्ट को ब्लेज़ प्राइसिंग प्लान में पहले से अपग्रेड नहीं किया है, तो ऐसा करने के लिए अपग्रेड पर क्लिक करें। (आपको केवल तभी अपग्रेड करने के लिए कहा जाएगा यदि आपका प्रोजेक्ट ब्लेज़ योजना पर नहीं है।)
  केवल ब्लेज़-स्तरीय परियोजनाएँ ही क्लाउड-आधारित API का उपयोग कर सकती हैं।
3. यदि क्लाउड-आधारित API पहले से सक्षम नहीं हैं, तो क्लाउड-आधारित API सक्षम करें पर क्लिक करें।
क्लाउड विजन एपीआई तक पहुंच को अस्वीकार करने के लिए अपनी मौजूदा फायरबेस एपीआई कुंजियां कॉन्फ़िगर करें:
1. क्लाउड कंसोल का क्रेडेंशियल पेज खोलें।
2. सूची में प्रत्येक API कुंजी के लिए, संपादन दृश्य खोलें, और कुंजी प्रतिबंध अनुभाग में, क्लाउड विज़न API को छोड़कर सभी उपलब्ध API को सूची में जोड़ें।

कॉल करने योग्य फ़ंक्शन को परिनियोजित करें

इसके बाद, क्लाउड फ़ंक्शन को परिनियोजित करें जिसका उपयोग आप अपने ऐप और क्लाउड विज़न एपीआई को ब्रिज करने के लिए करेंगे। functions-samples रिपॉजिटरी में एक उदाहरण है जिसका आप उपयोग कर सकते हैं।

डिफ़ॉल्ट रूप से, इस फ़ंक्शन के माध्यम से क्लाउड विज़न एपीआई तक पहुँचने से आपके ऐप के केवल प्रमाणित उपयोगकर्ता ही क्लाउड विज़न एपीआई तक पहुँच पाएंगे। आप विभिन्न आवश्यकताओं के लिए फ़ंक्शन को संशोधित कर सकते हैं।

समारोह को तैनात करने के लिए:

फ़ंक्शंस-नमूने रेपो को क्लोन या डाउनलोड करें और vision-annotate-image डायरेक्टरी में बदलें:
```
git clone https://github.com/firebase/functions-samples
cd vision-annotate-image
```
निर्भरताएँ स्थापित करें:
```
cd functions
npm install
cd ..
```
अगर आपके पास फायरबेस सीएलआई नहीं है, तो इसे इंस्टॉल करें ।
vision-annotate-image डायरेक्टरी में फायरबेस प्रोजेक्ट को इनिशियलाइज़ करें। संकेत मिलने पर, सूची में अपना प्रोजेक्ट चुनें।
```
firebase init
```
कार्य परिनियोजित करें:
```
firebase deploy --only functions:annotateImage
```

अपने ऐप में फायरबेस प्रमाणीकरण जोड़ें

ऊपर तैनात कॉल करने योग्य फ़ंक्शन आपके ऐप के गैर-प्रमाणीकृत उपयोगकर्ताओं के किसी भी अनुरोध को अस्वीकार कर देगा। यदि आपने पहले से ऐसा नहीं किया है, तो आपको अपने ऐप में Firebase प्रमाणीकरण जोड़ना होगा।

अपने ऐप में आवश्यक निर्भरताएँ जोड़ें

फायरबेस लाइब्रेरी के लिए क्लाउड फ़ंक्शंस स्थापित करने के लिए स्विफ्ट पैकेज मैनेजर का उपयोग करें।

अब आप छवियों को लेबल करने के लिए तैयार हैं।

1. इनपुट इमेज तैयार करें

क्लाउड विजन को कॉल करने के लिए, छवि को बेस 64-एन्कोडेड स्ट्रिंग के रूप में स्वरूपित किया जाना चाहिए। UIImage को संसाधित करने के लिए:

तीव्र

guard let imageData = uiImage.jpegData(compressionQuality: 1.0f) else { return }
let base64encodedImage = imageData.base64EncodedString()

उद्देश्य सी

NSData *imageData = UIImageJPEGRepresentation(uiImage, 1.0f);
NSString *base64encodedImage =
  [imageData base64EncodedStringWithOptions:NSDataBase64Encoding76CharacterLineLength];

2. छवि को लेबल करने के लिए कॉल करने योग्य फ़ंक्शन को प्रारंभ करें

एक छवि में वस्तुओं को लेबल करने के लिए, JSON क्लाउड विजन अनुरोध पास करने योग्य कॉल करने योग्य फ़ंक्शन को प्रारंभ करें।

सबसे पहले, क्लाउड फ़ंक्शंस का एक उदाहरण आरंभ करें:
तीव्र
```
lazy var functions = Functions.functions()
```
उद्देश्य सी
```
@property(strong, nonatomic) FIRFunctions *functions;
```

LABEL_DETECTION पर टाइप सेट के साथ एक अनुरोध बनाएं:

तीव्र

let requestData = [
  "image": ["content": base64encodedImage],
  "features": ["maxResults": 5, "type": "LABEL_DETECTION"]
]

उद्देश्य सी

NSDictionary *requestData = @{
  @"image": @{@"content": base64encodedImage},
  @"features": @{@"maxResults": @5, @"type": @"LABEL_DETECTION"}
};

अंत में, फ़ंक्शन का आह्वान करें:

तीव्र

functions.httpsCallable("annotateImage").call(requestData) { (result, error) in
  if let error = error as NSError? {
    if error.domain == FunctionsErrorDomain {
      let code = FunctionsErrorCode(rawValue: error.code)
      let message = error.localizedDescription
      let details = error.userInfo[FunctionsErrorDetailsKey]
    }
    // ...
  }
  // Function completed succesfully
}

उद्देश्य सी

[[_functions HTTPSCallableWithName:@"annotateImage"]
                          callWithObject:requestData
                              completion:^(FIRHTTPSCallableResult * _Nullable result, NSError * _Nullable error) {
        if (error) {
          if (error.domain == FIRFunctionsErrorDomain) {
            FIRFunctionsErrorCode code = error.code;
            NSString *message = error.localizedDescription;
            NSObject *details = error.userInfo[FIRFunctionsErrorDetailsKey];
          }
          // ...
        }
        // Function completed succesfully
        // Get information about labeled objects

      }];

3. लेबल की गई वस्तुओं के बारे में जानकारी प्राप्त करें

यदि इमेज लेबलिंग ऑपरेशन सफल हो जाता है, तो कार्य के परिणाम में BatchAnnotateImagesResponse की JSON प्रतिक्रिया वापस आ जाएगी। labelAnnotations सरणी में प्रत्येक वस्तु छवि में लेबल की गई किसी चीज़ का प्रतिनिधित्व करती है। प्रत्येक लेबल के लिए, आप लेबल का टेक्स्ट विवरण, इसकी नॉलेज ग्राफ़ इकाई आईडी (यदि उपलब्ध हो) और मैच का कॉन्फिडेंस स्कोर प्राप्त कर सकते हैं। उदाहरण के लिए:

तीव्र

if let labelArray = (result?.data as? [String: Any])?["labelAnnotations"] as? [[String:Any]] {
  for labelObj in labelArray {
    let text = labelObj["description"]
    let entityId = labelObj["mid"]
    let confidence = labelObj["score"]
  }
}

उद्देश्य सी

NSArray *labelArray = result.data[@"labelAnnotations"];
for (NSDictionary *labelObj in labelArray) {
  NSString *text = labelObj[@"description"];
  NSString *entityId = labelObj[@"mid"];
  NSNumber *confidence = labelObj[@"score"];
}