STLViewer зазвичай зберігає завантажені моделі у вбудованому сховищі. Якщо ви хочете, щоб самі файли моделей були в обліковому записі, який контролюєте ви, можна підключити Google Drive. Після цього нові моделі, завантажені з вашого облікового запису, зберігатимуться у спеціальній папці на вашому Drive.
Налаштування займає лише кілька кліків — без генерування токенів API, копіювання облікових даних і без кошика для налаштування. Ви авторизуєте STLViewer через стандартний екран входу Google, а все інше відбувається автоматично.
Цей посібник розповідає, що робить підключення, як його налаштувати, що очікувати після налаштування, а також як ним керувати або відключитися.
Що зміниться
- Нові моделі потрапляють на ваш Google Drive. Після ввімкнення підключення кожна нова модель, завантажена з вашого облікового запису, зберігається в папці STLViewer на вашому Drive.
- Попередні моделі залишаються на місці. Моделі, завантажені раніше, і далі працюють у вбудованому сховищі STLViewer. Ми не переносимо їх автоматично.
- Файли залишаються на Drive, якщо ви відключите сховище. Відключення видаляє записи моделей зі STLViewer, але не видаляє файли з вашого Drive.
- Нічого не потрібно налаштовувати в Google. Немає консолі розробника для відкриття, жодного API для ввімкнення і жодних налаштувань для зміни на стороні Google. Підключення відбувається виключно через стандартний екран входу Google.
- STLViewer бачить лише файли, які він сам створив. Дозвіл, який ви надаєте, використовує область
drive.file. Це означає, що STLViewer не має доступу до жодних наявних файлів або папок на вашому Drive — лише до файлів, які він сам завантажує. - Моделі на Drive не використовують ліміт сховища STLViewer. Файли зберігаються у вашому обліковому записі Google, у рахунок вашої квоти Google Drive.
Ця функція доступна тільки для зареєстрованих користувачів. Завантаження без облікового запису завжди використовують вбудоване сховище.
Перед початком
Вам потрібно:
- обліковий запис Google з Google Drive (підходить будь-який обліковий запис Google, зокрема безплатний)
- обліковий запис STLViewer, у який ви ввійшли
Крок 1 — Натисніть «Підключити Google Drive» на сторінці профілю
- Увійдіть до STLViewer.
- Відкрийте сторінку Профіль.
- Знайдіть картку Хмарне сховище.
- Натисніть Підключити Google Drive.
STLViewer готує безпечний запит авторизації та відкриває екран входу Google. Якщо ви вже ввійшли в Google у тому самому браузері, крок входу може бути пропущений і ви потрапите безпосередньо на екран дозволів.
Крок 2 — Оберіть обліковий запис Google
Якщо ви ввійшли в більш ніж один обліковий запис Google, з'явиться вікно вибору облікового запису. Оберіть той, чий Drive ви хочете використовувати для завантаження моделей у STLViewer.
Якщо замість вибору облікового запису ви бачите форму входу Google, введіть адресу електронної пошти та пароль потрібного облікового запису.
Крок 3 — Дозвольте доступ до Drive
Google показує екран дозволів із переліком того, що запитує STLViewer:
Перегляд, редагування, створення та видалення лише тих файлів на Google Диску, які ви використовуєте з цим застосунком.
Це область drive.file. Це найменший дозвіл, який дозволяє застосунку створювати й читати файли. Він означає, що STLViewer не бачить ваших наявних фотографій, документів та будь-якого іншого вмісту на Drive — лише моделі, які він сам завантажує.
Натисніть Дозволити, щоб надати дозвіл. Якщо ви натиснете Скасувати, підключення не відбудеться й ви повернетесь на сторінку профілю з повідомленням про незавершене підключення.
Крок 4 — STLViewer завершує налаштування
Після натискання «Дозволити» Google надсилає STLViewer безпечний токен. STLViewer потім:
- Створює папку STLViewer у кореневому каталозі вашого Drive, якщо її ще немає. Усі майбутні завантаження з вашого облікового запису STLViewer зберігатимуться в цій папці.
- Шифрує та зберігає підключення у вашому обліковому записі. Токен зашифровано. STLViewer ніколи не показує його вам і не надсилає до браузера.
- Перенаправляє вас назад на сторінку профілю з повідомленням «Google Drive підключено».
Картка «Хмарне сховище» тепер показує Google Drive зі значком Підключено.
Використання власного сховища
- Завантаження працює так само, як раніше. Нові завантаження з вашого облікового запису потрапляють до папки на Drive. Вибір файлу та індикатор прогресу завантаження працюють так само, як і раніше.
- Ви можете перевірити роботу безпосередньо в Drive. Завантажте тестову модель, а потім відкрийте Google Drive. Ви побачите папку STLViewer у кореневому каталозі Drive з новим файлом всередині.
- Доступ до моделей і їх перегляд досі здійснюється через STLViewer. Відвідувачу не потрібен доступ до вашого облікового запису Google або Drive. STLViewer читає файл із Drive і передає його переглядачу.
- Видалення моделі в STLViewer також видаляє файл із вашого Drive. Це незворотньо.
- Моделі все одно закінчуються. Кожна спільна модель має термін зберігання. Коли він спливає, STLViewer видаляє файл із вашої папки на Drive. Якщо вам потрібно зберегти оригінал назавжди, збережіть окрему копію поза папкою STLViewer.
Керування підключенням
Статус. Картка «Хмарне сховище» може показувати Підключено, Потрібне повторне підключення або Доступ відкликано. Якщо виникла проблема, остання помилка відображається під значком статусу.
Якщо ви відкликаєте доступ у налаштуваннях безпеки Google. Ви можете видалити доступ будь-якого застосунку до Drive, відвідавши сторінку myaccount.google.com/permissions. Якщо ви видалите там STLViewer, токен негайно перестає працювати. Наступного разу, коли STLViewer спробує прочитати або записати файл на вашому Drive, він виявить помилку та позначить підключення як Потрібне повторне підключення. Посилання на моделі, що зберігаються на Drive, показуватимуть «тимчасово недоступно», доки ви не підключитеся знову. Повторне підключення — це новий потік OAuth: перейдіть на сторінку профілю та знову натисніть Підключити Google Drive.
Папка STLViewer на Drive. Не перейменовуйте та не переміщуйте папку STLViewer на Drive. STLViewer знаходить папку за назвою. Якщо ви перейменуєте її, STLViewer під час наступного завантаження створить нову порожню папку, а файли в перейменованій папці стануть недоступними.
Відключення. Коли ви натискаєте Відключити, STLViewer просить вас ввести DISCONNECT для підтвердження. Відключення видаляє записи про моделі, що зберігаються на вашому Drive, зі STLViewer. Посилання для спільного доступу перестають працювати. Самі файли залишаються на вашому Drive — STLViewer їх не видаляє. Якщо ви хочете прибратися, відкрийте папку STLViewer на Drive та вручну видаліть її вміст.
Зміна облікового запису. Немає функції зміни облікового запису одним кліком. Відключіть поточний обліковий запис, а потім знову натисніть Підключити Google Drive і ввійдіть в інший обліковий запис Google.
Усунення неполадок
«Підключення не завершено» або ви повертаєтесь на сторінку профілю без повідомлення про успіх. Ви натиснули «Скасувати» на екрані дозволів Google. Поверніться на сторінку профілю та знову натисніть Підключити Google Drive. Цього разу натисніть Дозволити, коли Google покаже екран дозволів.
Повідомлення «Google Drive підключено» з'являється, але статус незабаром змінюється на «Потрібне повторне підключення». Це може статися, якщо токен Google закінчився до того, як STLViewer його використав, або якщо виникла короткочасна помилка. Спробуйте відключитися та підключитися знову.
«Активне підключення до сховища вже існує». У вас вже є підключене сховище — R2 або Drive — у вашому обліковому записі. Одночасно дозволено лише одне підключення до власного сховища. Відключіть поточне підключення на сторінці профілю, а потім підключіть Google Drive.
Завантажені моделі показують «тимчасово недоступно» для відвідувачів. Це означає, що STLViewer не може отримати доступ до вашого Drive. Найімовірніша причина — ви видалили STLViewer з дозволів вашого облікового запису Google. Перевірте статус підключення на сторінці профілю та при потребі підключіться знову.
Поширені запитання
Що саме бачить STLViewer на моєму Google Drive?
Лише файли, які він сам створив. Область drive.file обмежує доступ до файлів, завантажених застосунком. STLViewer не бачить ваших наявних документів, фотографій, таблиць та будь-якого іншого вмісту на Drive.
Чи можу я перейменувати папку STLViewer на Drive?
Краще ні. STLViewer знаходить папку за назвою «STLViewer». Якщо ви перейменуєте її, STLViewer під час наступного завантаження створить нову порожню папку, а файли в перейменованій папці стануть недоступними.
Чи використовує підключення Google Drive мою квоту Google Drive?
Так. Файли моделей зберігаються на вашому Drive та зараховуються до квоти Google Drive. Облікові записи Google зазвичай мають 15 ГБ безплатного місця, спільного для Drive, Gmail і Фото.
Чи потрібно щось налаштовувати на стороні Google перед підключенням?
Ні. Немає консолі Google Cloud для відкриття, жодного API для ввімкнення і жодних налаштувань для зміни у вашому обліковому записі Google. Все відбувається через потік входу, який надає STLViewer.
Чи можу я використовувати обліковий запис Google Workspace?
Зазвичай так, якщо ваша організація дозволяє стороннім застосункам доступ до Drive з областю drive.file. Якщо ваша організація це обмежує, підключення не вдасться після екрана дозволів Google. Зверніться до адміністратора Google Workspace для перевірки.
Чи переміщуються існуючі моделі після підключення Drive?
Ні. На ваш Drive потрапляють лише нові завантаження з авторизованого облікового запису. Наявні моделі залишаються у вбудованому сховищі й продовжують працювати як і раніше.
Що відбувається з моїми файлами після відключення?
Файли залишаються в папці STLViewer на вашому Drive. STLViewer видаляє лише власні записи моделей, тобто старі посилання для спільного доступу перестають працювати. Знайти та зберегти файли можна, відкривши Drive безпосередньо.
Чи можу я зберігати модель на Drive назавжди?
Ще ні. Наразі кожна модель має термін придатності. Коли він спливає, STLViewer видаляє файл із вашої папки на Drive. Опція «зберігати назавжди» для моделей у власному сховищі запланована, але ще не доступна.