डॉक्यूमेंटेशन

इंटरैक्टिविटी (लॉजिक नोड)

लॉजिक से तय होता है कि आपका AR अनुभव किसी बात पर कैसे प्रतिक्रिया दे। नोड पैनल में आप इवेंट (जो कुछ होता है) को एक्शन (जो कुछ किया जाना है) से जोड़ते हैं – कोडिंग की ज़रूरत नहीं।

यह कैसे काम करता है

हर नोड एक कार्ड है। दोनों नोड के बिंदुओं के बीच तार खींचकर आप किसी इवेंट नोड के आउटपुट को एक्शन नोड के इनपुट से जोड़ते हैं। इवेंट ट्रिगर होते ही जुड़े हुए एक्शन चल पड़ते हैं – और आप एक के बाद एक कई एक्शन जोड़ सकते हैं।

इवेंट को एक्शन से जोड़ें: यहाँ किसी ऑब्जेक्ट पर टैप करने से एनिमेशन चलता है।

नोड जोड़ने के लिए कैनवस पर राइट-क्लिक करें (या पैलेट का उपयोग करें)। नोड रंगों से पहचाने जाते हैं – इवेंट एम्बर रंग के और एक्शन आसमानी नीले रंग के होते हैं।

एक साथ कई नोड पर काम करने के लिए Shift दबाए रखें और खाली कैनवस पर खींचकर बॉक्स बनाएँ, या Shift-क्लिक करके (Ctrl/Cmd-क्लिक भी चलता है) नोड को चयन में जोड़ें। चयनित नोड खींचने पर साथ-साथ चलते हैं, और Delete कुंजी उन्हें हटा देती है – यही विकल्प राइट-क्लिक करने पर भी मिलता है।

इवेंट

इवेंटकब ट्रिगर होता है…
दृश्य शुरू होने परदृश्य पहली बार सामने आता है (टारगेट मिल जाता है, या आप “दृश्य पर जाएँ” के ज़रिए यहाँ पहुँचते हैं)।
टैप करने परउपयोगकर्ता आपके चुने हुए ऑब्जेक्ट पर टैप करता है (3D ऑब्जेक्ट या स्क्रीन पर दिखने वाला UI ओवरले एलिमेंट)।
टकराव होने परचुने हुए दो ऑब्जेक्ट एक-दूसरे को छूते हैं – नीचे टकराव देखें।
हाथ से छूने पर / छूना बंद होने परकोई हाथ या उँगली आपके चुने हुए इंटरैक्टिव ऑब्जेक्ट को छूना शुरू या बंद करती है – हाथ से इंटरैक्शन और फ़िज़िक्स देखें।
पकड़ने पर / छोड़ने परआपका चुना हुआ इंटरैक्टिव ऑब्जेक्ट उठाया या छोड़ा जाता है।

एक्शन

एक्शनयह क्या करता है
दृश्य पर जाएँवैकल्पिक ट्रांज़िशन (फ़ेड, स्केल, स्लाइड, स्पिन) और अवधि के साथ किसी दूसरे दृश्य पर जाएँ।
ध्वनि चलाएँइंपोर्ट की गई ऑडियो क्लिप चलाएँ, चाहें तो लूप में, उस आवाज़ पर जो उसका स्लाइडर तय करता है। इसका शुरू होते ही आउटपुट तुरंत चलता है; ध्वनि के बाद तब चलता है जब ध्वनि अंत तक चल जाती है (लूप में कभी नहीं, और बिल्कुल नहीं अगर उससे पहले ध्वनि रोकी जाए, वही ऑडियो फिर से चलाया जाए या सीन बदल जाए)।
ध्वनि रोकेंचल रही ध्वनि को रोकें – चुनी हुई ऑडियो क्लिप की चल रही हर प्रति रुक जाती है और शुरुआत पर लौट जाती है।
वीडियो चलाएँचुने हुए वीडियो ऑब्जेक्ट को किसी आवाज़ (0 पर बिना आवाज़) और गति पर, लूप में या बिना लूप के चलाना शुरू करें। शुरू होते ही तुरंत चलता है; वीडियो के बाद तब चलता है जब वीडियो अंत तक चल जाता है (लूप में कभी नहीं, और बिल्कुल नहीं अगर उससे पहले वीडियो रोका जाए, उसी ऑब्जेक्ट पर दूसरा वीडियो चलाया जाए या सीन बदल जाए)। जो ब्राउज़र टैप होने तक आवाज़ रोकता है, वह उसे बिना आवाज़ के चलाता है।
वीडियो रोकेंचुने हुए वीडियो ऑब्जेक्ट को रोकें और उसे शुरुआत पर लौटा दें।
एनिमेशन चलाएँकिसी ऑब्जेक्ट पर एनिमेशन क्लिप चलाएँ (कीफ़्रेम क्लिप या मॉडल में बना एनिमेशन)। इसका शुरू होते ही आउटपुट तुरंत चलता है। एनिमेशन के बाद तब चलता है जब क्लिप अपने अंत तक चल जाती है: लूप होने वाली क्लिप के लिए कभी नहीं, और बिल्कुल नहीं अगर उससे पहले एनिमेशन रोकें, उसी ऑब्जेक्ट पर कोई और एनिमेशन चलाएँ या सीन बदल जाए।
एनिमेशन रोकेंचल रहे एनिमेशन को रोकें – वह जिस जगह पर है, वहीं थम जाता है।
ऑब्जेक्ट दिखाएँ / ऑब्जेक्ट छिपाएँकिसी ऑब्जेक्ट को दिखाएँ या छिपाएँ।
फ़ेडआपके तय किए सेकंड में ऑब्जेक्ट को धीरे-धीरे दिखाएँ या ओझल करें। फ़ेड इन उसे दिखाता है और उसकी अपनी अपारदर्शिता (इंस्पेक्टर की अपारदर्शिता) तक ले जाता है। फ़ेड आउट उसे अदृश्य करके छिपा देता है, ताकि उस पर टैप न हो सके। इसके आउटपुट से जुड़ा काम फ़ेड पूरा होने पर चलता है। उसी ऑब्जेक्ट पर नया फ़ेड वहीं से आगे बढ़ता है जहाँ वह है।
विलंबइसके बाद जुड़ा अगला एक्शन चलने से पहले कुछ सेकंड रुकें।
फ़िज़िक्स सेट करें / इंटरैक्टिव सेट करेंटकराव वाले किसी ऑब्जेक्ट के लिए गुरुत्वाकर्षण, या छूना और पकड़ना, चालू या बंद करें।
धकेलने योग्य सेट करेंखुले हाथ को टकराव और फ़िज़िक्स वाले किसी ऑब्जेक्ट को धकेलने दें, या इसे रोकें।
ऑब्जेक्ट को धक्का देंफ़िज़िक्स वाले किसी ऑब्जेक्ट को धक्का दें।
ऑब्जेक्ट रीसेट करेंकिसी ऑब्जेक्ट को वहीं वापस रखें जहाँ दृश्य ने उसे शुरू में रखा था, स्थिर हालत में।

नोट

ध्वनि और वीडियो अपने दृश्य से आगे कभी नहीं चलते: जब अनुभव दृश्य पर जाएँ से दूसरे दृश्य में जाता है, तो जो कुछ भी चल रहा होता है – लूप में चलने वाली ध्वनियाँ भी – अपने-आप बंद हो जाता है।

एक उदाहरण

टैप करने पर कोई ऑब्जेक्ट दिखाने, ध्वनि चलाने, थोड़ी देर रुकने और फिर अगले दृश्य पर जाने के लिए:

  1. टैप करने पर नोड जोड़ें और ऑब्जेक्ट चुनें।
  2. इसे ऑब्जेक्ट दिखाएँ → ध्वनि चलाएँ → विलंब (2 सेकंड) → दृश्य पर जाएँ से जोड़ें।

वेरिएबल, गणित और लॉजिक

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

वेरिएबल एक नाम वाला मान है, जिसे आपका अनुभव चलते समय याद रख और बदल सकता है – जैसे स्कोर, काउंटर या चालू/बंद की स्थिति। बाईं ओर के वेरिएबल पैनल में वेरिएबल बनाएँ: हर एक को नाम, एक प्रकार (संख्या, टेक्स्ट या सही / ग़लत) और शुरुआती मान दें। कोई वेरिएबल दृश्य तक सीमित (अपना दृश्य शुरू होने पर हर बार रीसेट हो जाता है) या ग्लोबल (पूरे सत्र में सभी दृश्यों के बीच साझा) हो सकता है।

ये श्रेणियाँ दो तरह के तारों के साथ काम करती हैं:

  • फ़्लो तार (पहले की तरह) तय करते हैं कि आगे क्या चलेगा।
  • मान तार किसी नोड के आउटपुट से एक संख्या, टेक्स्ट या सही/ग़लत मान को दूसरे नोड के इनपुट तक पहुँचाते हैं – नीचे इन्हें नीले रंग में दिखाया गया है।
मान वाली तारें (नीली) नोड में डेटा पहुँचाती हैं; यहाँ हर टैप पर स्कोर में 1 जुड़ जाता है।
श्रेणीनोड
वेरिएबलवेरिएबल सेट करें (वेरिएबल में कोई मान रखें) और वेरिएबल पढ़ें (उसका मौजूदा मान पढ़ें)।
ऑपरेटरमान (एक तय मान), गणित (जोड़ / घटाव / गुणा / भाग / शेषफल), तुलना करें (बराबर, से कम, से ज़्यादा… → सही/ग़लत) तथा और / या / नहीं।
लॉजिकयदि (सही या ग़लत वाली शाखा चलाएँ), जब तक (शर्त सही रहने तक दोहराएँ) तथा गिनती लूप (शुरुआती मान से अंतिम मान तक गिनें)।

किसी वेरिएबल को स्क्रीन पर दिखाने के लिए UI ओवरले में एक टेक्स्ट एलिमेंट जोड़ें और उसका वेरिएबल दिखाएँ (लाइव) विकल्प चुनें – फिर वह टेक्स्ट मान को दिखाता है और मान बदलते ही अपडेट हो जाता है, जो लाइव स्कोर के लिए एकदम सही है।

नोट

वेरिएबल में बदलाव और यदि / जब तक / गिनती लूप के फ़ैसले लॉजिक चलते ही तुरंत हो जाते हैं। विलंब सिर्फ़ अपने बाद आने वाले एक्शन को रोकता है – किसी वेरिएबल के सेट होने या किसी शर्त की जाँच को नहीं। सुरक्षा के लिए लूप की भी एक सीमा तय है, ताकि कोई अनुभव कभी अटक न जाए।

टकराव: जब दो ऑब्जेक्ट एक-दूसरे को छूते हैं

टकराव होने पर इवेंट तब ट्रिगर होता है, जब दो ऑब्जेक्ट आपस में टकराते हैं।

  1. हर ऑब्जेक्ट को चुनें और इंस्पेक्टर में टकराव चालू करें – यह दोनों ऑब्जेक्ट पर चालू होना चाहिए।
  2. टकराव होने पर नोड जोड़ें और ऑब्जेक्ट A व ऑब्जेक्ट B चुनें।
  3. इसे उस एक्शन से जोड़ें जो होना चाहिए – जैसे कोई ध्वनि, स्कोर में बदलाव या दूसरे दृश्य पर जाना।
“टकराव होने पर” तब एक बार चलता है, जब टकराव चालू किए गए दो ऑब्जेक्ट के बॉक्स आपस में छू जाते हैं।

यह एक बार तब ट्रिगर होता है जब ऑब्जेक्ट के बॉक्स पहली बार आपस में ओवरलैप होते हैं, और दोबारा तभी होता है जब वे कम से कम एक चौथाई सेकंड अलग रहकर फिर से छूते हैं। इसलिए उन्हें साथ-साथ पकड़े रखने से, या किसी ऑब्जेक्ट के पल भर के लिए दूसरे से टकराकर उछलने या हिलने से, यह दोबारा ट्रिगर नहीं होगा। A और B का क्रम मायने नहीं रखता। टकराव सिर्फ़ दृश्य के 3D ऑब्जेक्ट के लिए है, स्क्रीन पर दिखने वाले UI ओवरले एलिमेंट के लिए नहीं।

हर ऑब्जेक्ट का बॉक्स उसकी सीमाओं के हिसाब से बनता है, अगर आपने उन्हें बदला है (मेश को छोड़कर किसी भी प्रकार में), वरना ऑब्जेक्ट जैसा दिखता है उसके हिसाब से। जिस समतल पर फ़र्श चालू है, वह हमेशा ठोस माना जाता है, इसलिए टकराव होने पर नोड उसे भी चुन सकता है।

नोट

अगर आप कोई ऐसा ऑब्जेक्ट या दृश्य मिटा देते हैं जिससे कोई नोड जुड़ा है, तो AR Works उस जुड़ाव को हटा देता है और नोड पर चेतावनी का बैज दिखाता है, ताकि साफ़ दिखे कि नोड को दोबारा चुनना है, न कि वह चुपचाप कुछ किए बिना पड़ा रहे।

टिप

अपने लॉजिक को तुरंत जाँचने के लिए पूर्वावलोकन का उपयोग करें – ब्राउज़र में ही ऑब्जेक्ट पर टैप करके देखें।