Тяо Яо

ohpm install @shijing/taoyao

TaoYao.with(this)
      .runtime()
      // Разрешения, которые требуется запросить
      .permission(permissions)
      .onGranted(() => {
        // Запрос разрешений выполнен успешно
      })
      .onDenied(() => {
        // Запрос разрешений провалился
      })
      .request()

ohos.permission.READ_MEDIA

ohos.permission.WRITE_MEDIA

Система предлагает режим сверхконфиденциальности. Когда этот режим активирован в настройках системы, камера, микрофон и местоположение становятся недоступными. После получения доступа к камерным, аудио и геолокационным правам, если режим сверхконфиденциальности активирован, следует направить пользователя к деактивации этого режима.```javascript
if (!TaoYao.isLocationEnabled()) {
  // Активирован режим сверхконфиденциальности или выключен переключатель локализации, откроем глобальное окно с запросом активации/деактивации режима
  TaoYao.requestLocationGlobalSwitch(context).then(isOpen => {
    if (isOpen) {
      // Переключатель локализации открыт
    } else {
      // Переключатель локализации закрыт
    }
  });
}

}))
} else {
  // Локационный режим включен
}
TaoYao.isMicrophoneMute().then(isMute => {
  if (isMute) {
    // Включен режим максимальной конфиденциальности, микрофон отключен, показывается глобальное окно с запросом пользователя выключить этот режим
    TaoYao.requestMicrophoneGlobalSwitch(context).then((isOpen => {
      if (isOpen) {
        // Микрофон включен
      } else {
        // Микрофон отключен
      }
    }))
  } else {
    // Микрофон включен
  }
})
if (TaoYao.isCameraMuted(context)) {
  // Включен режим максимальной конфиденциальности, камера недоступна, показывается глобальное окно с запросом пользователя выключить этот режим
  TaoYao.requestCameraGlobalSwitch(context).then(isOpen => {
    if (isOpen) {
      // Камера включена
    } else {
      // Камера отключена
    }
  })
} else {
  // Камера включена
}

TaoYao.with(this.context)
      .notification()
      .permission()
      .```javascript
onGranted(() => {
          // Успешный запрос прав на уведомления
          this.toast()
        })
        .onDenied(() => {
          // Для отказа в правах на уведомления можно лишь перейти в системные настройки
          TaoYao.goToSettingPage(this.context)
        })
        .request()

  /**
   * Проверка наличия прав, если нет прав, то они не будут запрошены
   *
   * @param permissions
   * @returns true если есть права
   */
  static hasPermission(permissions: Array<Permissions>): boolean {
    const generalChecker = new GeneralChecker()
    return generalChecker.hasPermission(permissions)
  }

  /**
   * Проверка наличия прав на уведомления, если таких прав нет, то они не будут запрошены
   *
   * @returns Promise<boolean>, где true — поддерживается, false — не поддерживается
   */
  static isNotificationEnabled(): Promise<boolean> {
    return NotificationPermissionChecker.isNotificationEnabled()
  }

  /**
   * Проверка поддержки распределённых уведомлений
   *
   * @returns true если поддерживается, false если не поддерживается
   */
```markdown
### Системный выборщик
Системный выборщик уже получил предварительное разрешение на соответствующие права, поэтому разработчики могут использовать системный выборщик без повторной заявки на права для временного ограниченного доступа к соответствующим ресурсам.
```Например, когда приложение требует чтения пользовательских изображений, это можно сделать с помощью фотографического выборщика. После того как пользователь выберет нужное изображение, оно будет возвращено непосредственно, без необходимости предоставления приложению прав на чтение файлов изображений.
<br/>
```#### Контактный выборщик
Получение контактов через контактный выборщик не требует получения разрешения на доступ к адресной книге.

TaoYao.with(this.context)
      .camera()
      .onSuccess((uri) => {
        // путь к файлу снимка или видео в песочнице
        console.log(uri);
      })
      .onError((err) => {
        console.log(err.stack);
      })
      .openSystemCamera(new CameraBuilder()
        // задний модуль камеры, используется по умолчанию
        .setCameraSelector(CameraSelector.CAMERA_POSITION_BACK)
        // можно выбрать только фото или только видео, по умолчанию выбираются оба
        .setUseCase([UseCase.PHOTO, UseCase.VIDEO])
        // путь сохранения файла, может быть не указан
        //.setSaveUri("")
        // максимальная длительность записи видео, может быть не указана
        //.setVideoMaxDuration());
      );

TaoYao.with(this.context)
      .media()
      .onSuccess((uris) => {
        uris.forEach((uri) => {
          console.log("yunfei", uri);
        });
      })
      .onError((err) => {
        console.log(err.stack);
      })
      .select(new MediaBuilder()
        // максимальное количество выбранных медиафайлов
        .setMaxSelectNumber(10)
        // типы медиафайлов, которые могут быть выбраны, тип изображений, тип видео, тип изображений и видео, тип анимированного изображения
        .setMediaMineType(MediaMimeType.IMAGE_VIDEO_TYPE));
```#### Выборщик документов
Запуск системы выборщика документов не требует получения разрешений, позволяет получить только выбранные документы.
```javascript
TaoYao.with(this.context)
      .document()
      .onSuccess((uris) => {
        uris.forEach((uri) => {
          console.log("yunfei", uri);
        });
      })
      .onError((err) => {
        console.log(err.stack);
      })

#### Выборщик документов
```Выборщик документов не требует специальных разрешений, но позволяет выбрать до 10 медиафайлов.

```javascript
select(new DocumentBuilder()
         // Ограничение максимального количества выбранных файлов
         .setMaxSelectNumber(10)
         // Указание пути к файлу или директории по умолчанию (необязательно)
         //.setDefaultFilePathUri("")
         // Разрешение доступа к выбранному файлу или директории, true — разрешено, false — запрещено (необязательно)
         //.setAuthMode(false)
         // Фильтрация типов файлов ['описание типа файла | расширение файла'] (необязательно)
         // Например: ['Изображения (.png, .jpg)|.png,.jpg', 'Документы|.txt', 'Видео|.mp4', '.pdf']
         .setFileSuffixFilters(['Документы|.docx'])
       )

TaoYao.with(this.context)
      .audio()
      .onSuccess((uris) => {
        uris.forEach((uri) => {
          console.log("yunfei", uri);
        });
      })
      .onError((err) => {
        console.log(err.stack);
      })
      // На данный момент аудио выборщик не поддерживает конфигурирование параметров, по умолчанию можно выбрать все типы аудиофайлов.
      .select(new AudioBuilder());