תיעוד Nodaroהטמעות
שתי הדרכים להטמיע את Nodaro במוצר שלכם: מיני־אפליקציה שמריצה תהליך שפורסם, או התצוגה התלת־ממדית שלא שומרת מצב, ומתי להשתמש בכל אחת מהן.
הטמעות מכניסות חלק מ-Nodaro לתוך המוצר שלכם. יש שתיים, והן פותרות בעיות שונות. הטמעת המיני־אפליקציה מריצה תהליך שפורסם למשתמשים שלכם, והתצוגה התלת־ממדית מציגה סצנת תלת־ממד, ואם רוצים גם מאפשרת לערוך אותה, בלי להריץ שום דבר.
בחירת הטמעה
| מיני־אפליקציה | התצוגה התלת־ממדית | |
|---|---|---|
| מה היא עושה | מריצה מיני־אפליקציה שפורסמה: אוספת את הקלטים, מתחילה הרצה ומציגה את התוצאה. | מציגה תוכנית של סצנת תלת־ממד: אזור התצוגה, הניגון, רשימת האובייקטים, עורכי התנוחה והיסטוריית הגרסאות. |
| איך מטמיעים אותה | ממשק משלכם על ה-REST API, או iframe מקוד ההטמעה של המיני־אפליקציה. | iframe בכתובת /embed/scene3d, ששולטים בו עם postMessage. |
| אימות | ממשק משלכם משתמש באסימון API אישי או באסימון OAuth, ששמורים בשרת שלכם. ה-iframe פועל עם הסשן של הצופה עצמו ב-Nodaro. | אין. ל-iframe אין סשן, והוא לא שולח שום בקשה לרשת. |
| קרדיטים | כל הרצה עולה קרדיטים, והחשבון שההרצה פועלת בשמו משלם עליה. | אף פעם לא עולה קרדיטים. התצוגה לא מריצה שום משימה. |
| איפה נשמר המצב | ההרצות נשמרות ב-Nodaro. | הדף שלכם שומר את הסצנה. ה-iframe לא שומר שום דבר אחרי טעינה מחדש. |
מתי להטמיע מיני־אפליקציה
- פרסמתם תהליך כמיני־אפליקציה, והמשתמשים שלכם צריכים להריץ אותו מהאתר או מהאפליקציה שלכם. ראו את הדף אפליקציות.
- אתם רוצים טופס ועיצוב משלכם סביב האפליקציה. בנו אותם על ה-REST API.
- אתם רוצים את הדרך המהירה ביותר. הדביקו את קוד ההטמעה של המיני־אפליקציה בדף שלכם.
ראו את הדף הטמעת מיני־אפליקציה.
מתי להטמיע את התצוגה התלת־ממדית
- המוצר שלכם שומר תוכניות של סצנות תלת־ממד, ממשימות של הרכיבים יצירת סצנת תלת־ממד ועריכת סצנת תלת־ממד, והמשתמשים שלכם צריכים לראות אותן.
- המשתמשים שלכם צריכים לנגן סצנה, לגלול בציר הזמן שלה ולבחור בה אובייקטים, במצב צפייה בלבד כברירת מחדל.
- המשתמשים שלכם צריכים לערוך תנוחות, צבעים ונעילות, והדף שלכם שומר כל גרסה חדשה.
ראו את הדף הטמעת התצוגה התלת־ממדית, ואת הדף פורמט תוכנית הסצנה כדי להכיר את הנתונים שהתצוגה מציגה.
האסימון נשאר מחוץ לדפדפן בשתי ההטמעות
אף אחת מההטמעות לא מכניסה אסימון של Nodaro לדף האינטרנט שלכם. כשאתם בונים ממשק משלכם למיני־אפליקציה, האסימון נשאר בשרת שלכם. התצוגה התלת־ממדית אף פעם לא כוללת אסימון בהודעות שלה: הדף שלכם מביא את הקבצים של הסצנה עם הסשן שלו ושולח את הבייטים.
שאלות נפוצות
מה אפשר להטמיע מ-Nodaro?
מ-Nodaro אפשר להטמיע שני דברים: מיני־אפליקציה, שהיא תהליך שפורסם עם טופס פשוט, והתצוגה התלת־ממדית, שמציגה תוכנית של סצנת תלת־ממד שהדף שלכם שולח אליה.
איזו הטמעה של Nodaro מריצה יצירות AI?
מבין ההטמעות של Nodaro, רק הטמעת המיני־אפליקציה מריצה יצירות AI. התצוגה התלת־ממדית לא מריצה כלום, אין לה סשן, היא לא שולחת שום בקשה לרשת ואף פעם לא מוציאה קרדיטים.
האם צריך אסימון API כדי להטמיע את התצוגה התלת־ממדית?
לא. התצוגה התלת־ממדית לא צריכה אסימון ולא צריכה סשן. הדף שלכם שולח את הסצנה עם postMessage, ומביא עם הסשן שלו את הקבצים הבינאריים של הסצנה, אם יש כאלה.
איפה נשמר האסימון כשאני בונה ממשק משלי למיני־אפליקציה?
האסימון נשמר בשרת שלכם. קוד הדפדפן שלכם מדבר עם השרת שלכם, והשרת קורא ל-API של Nodaro עם האסימון, כך שהאסימון אף פעם לא מגיע לדפדפן.
דפים קשורים
הטמעת מיני־אפליקציה
הטמעת התצוגה התלת־ממדית
פורמט תוכנית הסצנה
אפליקציות (מיני־אפליקציות)
עודכן לאחרונה
קטלוגי הבוררים
בנו את בוררי Nodaro באפליקציה שלכם עם @nodaro/prompts, הפכו בחירות לביטויי פרומפט, תרגמו תוויות, הציגו תמונות או קבלו את הקטלוגים דרך ה-API.
הטמעת מיני־אפליקציה
הריצו במוצר שלכם מיני־אפליקציה של Nodaro שפורסמה, עם קוד ההטמעה או עם טופס משלכם על ה-REST API: מקריאת הקלטים ועד הרצות, תוצאות ושגיאות.