功能说明
Полезно знать
- Источник облачного хранилища может читать только файлы в учётной записи, которую вы авторизовали для Primuse. Авторизация хранится в связке ключей устройства.
- Каждый источник хранит отдельные учетные данные. Отмена или неудачная авторизация оставляет существующие соединения без изменений.
- Сканирование облачного хранилища сначала считывает только имена файлов; сведения о песнях заполняются позже в фоне, пакетами (см. «Экономия трафика» ниже).
С чего начать
Настройки → Управление источниками (в группе Медиатека) → +, затем выберите хранилище в разделе Облачный диск. На Mac его также можно добавить в разделе Источники боковой панели.
Три способа входа
| Способ | Хранилища | Что нужно |
|---|---|---|
| Авторизация в браузере | Baidu Pan, Aliyun Drive, Google Drive, OneDrive, Dropbox, 123 Pan, GuangYa Pan, pCloud | Учётная запись хранилища; некоторым сборкам также нужны ваши собственные учётные данные разработчика (см. ниже) |
| Токен доступа к API | Drime | Токен, созданный в веб-настройках Drime |
| Пароль приложения | InfiniCLOUD | Учётная запись InfiniCLOUD и пароль приложения |
После добавления 115 Drive отображается «… пока недоступен.»: Primuse подает заявку на официальный доступ к открытой платформе …. После одобрения вы сможете войти в систему напрямую — следите за обновлениями. Если у вас уже есть приложение для разработчиков на этой платформе, вы можете ввести учетные данные ниже, чтобы попробовать его сейчас.
Шаги авторизации в браузере
- Выберите тип хранилища и сохраните; откроется страница подключения, на которой сначала отображается «Проверка статуса авторизации…».
- Если появилась кнопка Авторизоваться:
- iPhone / iPad: Нажмите кнопку ниже, чтобы открыть страницу авторизации в браузере. После входа в систему и предоставления доступа Primuse сможет читать ваши файлы.
- Mac: Нажмите «Авторизовать», чтобы открыть страницу авторизации в системном браузере. После входа в систему и предоставления доступа вы автоматически вернетесь в Primuse.
- Войдите в учётную запись хранилища в браузере и разрешите доступ. Во время ожидания Primuse показывает «Ожидание, пока системный браузер вернет код авторизации…». На Mac отображается список «Этапы авторизации»; Это окно автоматически откроет браузер каталогов после завершения авторизации. Не закрывайте страницу обратного вызова в системном браузере.
- После успешной авторизации откроется просмотр папок. Выберите папки с музыкой и запустите сканирование.
Если на устройстве уже выполнен вход в хранилище того же типа, вы увидите два варианта: Использовать учетную запись, вошедшую в систему. и Войдите в другую учетную запись..
Если нужны учётные данные разработчика
Если на странице подключения отображается «Требуются учетные данные разработчика.», в этой сборке нет встроенных учётных данных для этого хранилища, и вам нужно получить собственные на открытой платформе хранилища. На странице показаны четыре шага:
- Инструкции платформы, например: Перейдите на pan.baidu.com/union, чтобы зарегистрировать приложение для разработчиков.; Перейдите на alipan.com/developer, чтобы подать заявку на доступ.; Перейдите на console.cloud.google.com, чтобы создать учетные данные OAuth.; Перейдите на сайт entra.microsoft.com, чтобы зарегистрировать приложение.; Перейдите на сайт dropbox.com/developers/apps, чтобы создать приложение.; Перейдите на 123pan.cn/developer, чтобы подать заявку на приложение для разработчиков.; Перейдите на app.guangyapan.com/pan/docs/open-api, чтобы подать заявку на приложение для разработчиков.; Перейдите на docs.pcloud.com/my_apps, создайте приложение и разрешите Implicit Grant
- Создайте приложение и получите идентификатор клиента (и секрет клиента).
- Вернитесь в Primuse, отредактируйте этот источник и введите учетные данные. (поля: Идентификатор клиента/ключ приложения и Секрет клиента или Секрет клиента (необязательно))
- Еще раз нажмите «Подключиться», чтобы авторизоваться.
По исходному коду нельзя определить, для каких хранилищ в версии из App Store есть встроенные учётные данные (это зависит от конфигурации релизной сборки). Ориентируйтесь на то, что фактически показывает страница подключения.
Если авторизация не удалась
Страница ошибки называется «Не удалось подключиться», ниже указана конкретная причина. Коснитесь Повторить авторизацию, чтобы авторизоваться снова, или Повторная проверка, чтобы повторно проверить сохранённую авторизацию. Частые причины:
- «Идентификатор клиента не настроен.»: введите учётные данные разработчика, как описано выше.
- «Пароль временно недоступен. Разблокируйте устройство и повторите попытку.»: разблокируйте устройство, затем коснитесь Повторная проверка.
- «Невозможно безопасно прочитать сохраненный пароль. Повторите попытку или обновите учетные данные.»: авторизуйтесь снова.
- «Не удалось сохранить токен авторизации.»: повторите авторизацию; если ошибка сохраняется, соберите диагностические данные, см. Как собрать и отправить диагностику разработчику.
- pCloud показывает «Авторизация pCloud больше недействительна. Авторизуйтесь снова.»: авторизуйтесь снова.
- Guangya показывает «В этой сборке нет учётных данных GuangYa (client ID, project ID, ключ подписи)»: эта версия не может подключиться к Guangya; дождитесь новой версии.
Drime: используйте токен доступа к API
- Выберите Drime. На странице подключения отображается «Подключиться к Drime»: Вставьте токен доступа API, созданный в настройках Drime → Разработчик. Primuse проверяет его перед открытием диска.
- Вставьте токен в поле Токен доступа API и коснитесь Подключиться к Drime.
- Создайте токен в Drime Settings → Developer, затем вставьте его сюда. Токен надежно хранится в Keychain.
Разрешения: All — воспроизведение, запись и удаление; Read Only — просмотр и воспроизведение; Restricted требует Files: Read, а для записи сопутствующих файлов и удаления — также Files: Write. При редактировании источника: Оставьте поле пустым, чтобы сохранить существующий токен Дриме, или введите новый токен, чтобы заменить его.
Если появляется «Текущий токен Drime не может читать файлы.» или «Текущий токен Drime доступен только для чтения или не может записывать и удалять файлы.», измените разрешения токена в Drime и подключитесь снова.
InfiniCLOUD: используйте пароль приложения
Введите имя пользователя InfiniCLOUD и пароль приложения. В разделе My Page в InfiniCLOUD включите подключение внешних приложений и введите созданный пароль приложения. Если появляется «В этой версии InfiniCLOUD не настроен.», эта версия не может подключиться к InfiniCLOUD.
Экономия трафика: загружать сведения только по Wi-Fi
Откройте Настройки → Хранилище (в группе Медиатека) → Wi-Fi только для получения подробной информации об облаке..
Облачное сканирование предварительно извлекает только имена файлов. Детали трека (исполнитель, альбом, обложка, продолжительность) загружаются в фоновом режиме — около 256 КБ на песню. Если этот параметр включен, загрузка сотовой сети приостанавливается и возобновляется при повторном подключении к Wi-Fi.
Вход в облачное хранилище на Apple TV
На Apple TV нет браузера, поэтому вход в облачные хранилища выполняется по QR-коду:
- Большинство хранилищ: телевизор показывает QR-код; подсказка, например, такая: «Отсканируйте код камерой iPhone или iPad, чтобы войти в … через Primuse. Данные входа будут переданы прямо на этот Apple TV по локальной сети.» На телефоне должно быть установлено приложение Primuse, и он должен находиться в той же локальной сети, что и Apple TV.
- Телефон показывает «Вход в … для Apple TV»: После входа на этом устройстве авторизация будет зашифрована и передана на Apple TV по локальной сети. На этом устройстве источник не добавляется, а авторизация здесь не сохраняется. Убедитесь, что код на Apple TV совпадает с кодом ниже
- По завершении: Готово. Теперь Apple TV предложит выбрать папки для сканирования.
- Если телефон сообщает «Эта версия Primuse пока не умеет входить в этот сервис с телефона от имени Apple TV.», войти в это хранилище с телефона пока нельзя.
Частые ошибки: «Apple TV не подключён к локальной сети, поэтому не может показать QR-код.», «Не удалось подключиться к Apple TV. Убедитесь, что оба устройства находятся в одной локальной сети, а QR-код по-прежнему отображается на Apple TV.», «Apple TV не принял этот вход — возможно, QR-код уже сменился. Отсканируйте код на Apple TV ещё раз.».
Ограничения
- Первое сканирование считывает только имена файлов. Сведения об исполнителе, альбоме, обложке и длительности заполняются позже пакетами, что для больших медиатек занимает время. Если Wi-Fi только для получения подробной информации об облаке. включено, в сотовой сети это приостанавливается.
- Если вы отозвали доступ на сайте хранилища или авторизация истекла, авторизуйтесь в Primuse снова.
- Настройки воспроизведения, кэша и офлайн-загрузок см. в статье Офлайн-загрузки, аудиокэш и управление хранилищем.