व्हाइट लेबल स्मार्ट संपादक

एकीकरण चरण

तेज़ी से शुरुआत को पहले पढ़ना याद रखें।

1. सर्वर API का इस्तेमाल करके एक इमेज अपलोड करें।

2. नीचे वर्णित अनुसार व्हाइट लेबल स्मार्ट संपादक को एम्बेड करें।

3. आपके कोड द्वारा प्राप्त कॉलबैक पर प्रतिक्रिया करें क्योंकि आपका मानव ऑपरेटर इमेजिस को क्लिप करता है, जैस्रे कि अपने बैकएंड को नए उपलब्ध परिणामों को डाउनलोड करने का निर्देश देकर।

यह एकीकरण विकल्प आपको पूर्ण नियंत्रण प्रदान करता है, लेकिन इसके लिए एक गहरे फ्रंट-एंड एकीकरण की आवश्यकता होती है। अगर आपको आसान एकीकरण विकल्प की जरूरत है, तो कृपया होस्ट किए गए स्मार्ट संपादक को देखें।

सेटअप

ClippingMagic.js इस्तेमाल करने के लिए, इसे उन पेजेस पर शामिल और शुरू करके प्रारंभ करें जहाँ आप संपादन की अनुमति देना चाहते हों:

<script src="https://clippingmagic.com/api/v1/ClippingMagic.js" type="text/javascript"></script>
<script type="text/javascript">
  function myCallback(opts) {
    // TODO: Replace this with your own functionality
    switch (opts.event) {
      case "error":
          alert("An error occurred: " + opts.error.status + ", " + opts.error.code + ", " + opts.error.message);
          break;

      case "result-generated":
          alert("Generated a result for " + opts.image.id + ", " + opts.image.secret);
          break;

      case "editor-exit":
          alert("The editor dialog closed");
          break;
    }
  }
  var errorsArray = ClippingMagic.initialize({apiId: 123});
  if (errorsArray.length > 0) alert("Sorry, your browser is missing some required features: \n\n " + errorsArray.join("\n "));
</script>

एकल इमेज संपादित करें

आप निम्नलिखित तरीके से एकल इमेज के लिए संपादक प्रदर्शित कर सकते हैं:

ClippingMagic.edit({
    "image" : {
      "id" : 2346,
      "secret" : "image_secret1"
    },
    "useStickySettings" : true,
    "hideBottomToolbar" : false,
    "locale" : "hi-IN"
  }, myCallback);

कॉलबैक फंक्शन को या तो result-generated या editor-exit से कॉल किया किया जाएगा, लेकिन दोनों से नहीं। प्रत्येक इंगित करता है कि संपादक बंद कर दिया गया है।

फैक्टरी डिफॉल्ट सेटिंग्स का इस्तेमाल करने के लिए useStickySettings के लिए false छोड़ें या पास इन करें।

चूंकि यह DOM के संदर्भ में है, इसलिए संबंधितदस्तावेज़ तैयार होने के ईवेंट के बाद कॉल किया जाना सुनिश्चित करें।

अनुक्रम में विविध इमेजेस संपादित करें

आप निम्नलिखित तरीके से बहुत-सी इमेजेस को संपादित करने के लिए संपादक प्रदर्शित कर सकते हैं:

ClippingMagic.edit({
    "images" : [ {
      "id" : 2346,
      "secret" : "image_secret1"
    }, {
      "id" : 2347,
      "secret" : "image_secret2"
    } ],
    "useStickySettings" : true,
    "hideBottomToolbar" : false,
    "locale" : "hi-IN"
  }, myCallback);

उपयोगकर्ता द्वारा उत्पन्न प्रत्येक परिणाम के लिए कॉलबैक फंक्शन को result-generated के साथ एक बार कॉल किया जाएगा (= 'संपन्न' पर प्रत्येक क्लिक एक बार)। अंत में एक editor-exit कॉल होगी जो कि इंगित करेगी कि या तो उपयोगकर्ता द्वारा X क्लिक करने के कारण या संपादन के लिए इमेजेस समाप्त होने के कारण संपादक बंद हो गया है। जब उपयोगकर्ता किसी इमेज को छोड़ता है, तो कोई कॉलबैक नहीं होगा।

फैक्टरी डिफॉल्ट सेटिंग्स का इस्तेमाल करने के लिए useStickySettings के लिए false छोड़ें या पास इन करें।

चूंकि यह DOM के संदर्भ में है, इसलिए संबंधितदस्तावेज़ तैयार होने के ईवेंट के बाद कॉल किया जाना सुनिश्चित करें।

कॉलबैक function(opts)

edit फंक्शन callback फंक्शन को मापदंड के तौर पर लेता है। यह कॉलबैक आपको उपयोगकर्ता कार्रवाइयों का प्रत्युत्तर देने और इमेज संपादन प्रगति के बारे में आपके बैकएंड सर्वर को सूचित करने देता है।

कालबैक का सिग्नेचर function(opts) है और अपवाद और लौटाए गए मानों पर ध्यान नहीं दिया जाता। opts मापदंड PlainObject है जिसमें ये मौजूद है:

जैसे ही संपादक बंद कर दिया जाता है आप फिर से edit() को कॉल कर सकते हैं (इससे पहले किए गए कॉल अपवाद की ओर ले जाते हैं)।

callback({
  "event" : "result-generated",
  "image" : {
    "id" : 2346,
    "secret" : "image_secret1"
  }
}); 

फंक्शन परिभाषाएं

ClippingMagic.initialize(opts) -> array_of_missing_features

initialize फंक्शन PlainObject वाले ऐसी कुंजी/मान वाले जोड़े लेता है जो कि प्रारंभ करने को कॉन्फिगर करते हैं:

यह फंक्शन स्ट्रिंग्स वाला जावास्क्रिप्ट ऐरे वापस करता है जिसमें ऐसी फीचर्स का वर्णन होता है जो मौजूदा ब्राउज़र में गायब हैं, परंतु संपादक को चलाने के लिए आवश्यक हैं। यदि यह ऐरे खाली है, तो आप आगे जा सकते हैं और edit फंक्शन को कॉल कर सकते हैं।

ClippingMagic.edit(opts, callback)

edit फंक्शन निम्नलिखित मापदंड लेता है:

यह तरीका मान नहीं लौटाता है। यदि इस तरीके को कॉल करने से पहले initialize को कॉल नहीं किया गया है, या यदि initialize गैर-रिक्त ऐरे वापस लौटाता है, या संपादक विंडों पहले ही खुली हो, तब एक अपवाद दिया जाता है।