Подписка на сообщество для iOS

• если вы используете авторизацию через SDK:
  • чтобы показать окно подписки после авторизации через кнопку One Tap, шторку авторизации, виджет 3 в 1 или пользовательскую кнопку, указывать доступ в коде не нужно, он добавится автоматически;
  • чтобы отобразить окно подписки в любой момент при использовании приложения, пропишите доступ groups в коде вашего приложения.
• если вы используете авторизацию без SDK, добавьте scope=groups в URL для авторизации:
  https://id.vk.ru/authorize?response_type=code&client_id=12345&scope=groups

Лимиты показа окна подписки на сообщество

• задать количество показов окна;
• указать для этого количества показов период в днях;
• полностью отключить лимиты показа окна.

import VKID

do {
    let vkid = try VKID(
        config: Configuration(
            appCredentials: AppCredentials(
                clientId: clientId,         // ID вашего приложения.
                clientSecret: clientSecret  // Ваш защищённый ключ (client_secret).
            ),
            groupSubscriptionsLimit: GroupSubscriptionsLimit(
                maxSubscriptionsToShow: 2,  // Количество показов окна подписки.
                periodInDays: 30            // Период для этого количества показов.
            )
        )
    )
} catch {
    preconditionFailure("Failed to initialize VKID: \(error)")
}

Показ окна подписки на сообщество после авторизации пользователя

1. Создайте конфигурацию GroupSubscriptionConfiguration.
   let authConfiguration: AuthConfiguration = .init(
        groupSubscriptionConfiguration: .init(
            subscribeToGroupId: "1",  // Замените "1" на ID вашего сообщества.
            onCompleteSubscription: { result in
                switch result {
                case .success:
                    print("Успешная подписка")
                case .failure(let error):
                    print("Не удалось подписаться: \(error)")
                }
            },
            buttonType: .custom(.init(height: .medium(.h44), cornerRadius: 12)),
            sheetCornerRadius: 24
        )
    )

2. Получите UI-элемент.

let oneTapConfig = OneTapButton(authConfiguration: authConfiguration, onCompleteAuth: nil)
let oneTap = self.vkid?.ui(for: oneTapConfig).uiView()

Самостоятельный запуск окна подписки на сообщество

1. Создайте конфигурацию GroupSubscriptionSheet.
   let sheetConfig = GroupSubscriptionSheet(
       subscribeToGroupId: "1",  // Замените "1" на ID вашего сообщества.
       buttonConfiguration: .init(
           height: .medium(.h44),
           cornerRadius: 12
       ),
       theme: .matchingColorScheme(.light),
       sheetCornerRadius: 24,
       presenter: .newUIWindow
   ) { result in
       switch result {
       case .success:
           print("Успешная подписка")
       case .failure(let error):
           print("Не удалось подписаться: \(error)")
       }
   } accessTokenProvider: { force, completion in
       guard let session = self.vkid?.currentAuthorizedSession else {
           return
       }
       session.getFreshAccessToken(forceRefresh: force) { result in
           switch result {
           case .success((let accessToken, _)):
               completion(.success(accessToken.value))
           case .failure(let error):
               completion(.failure(error))
           }
       }
   }

2. Получите uiViewController и отобразите его модально.
   self.vkid?.ui(for: sheetConfig).uiViewController { [weak self] result in
       switch result {
       case .success(let viewController):
           self?.present(viewController, animated: true)
       case .failure(let error):
           print("Не удалось создать шторку подписки на сообщество: \(error)")
       }
   }

Стилизация кнопок внутри окна подписки на сообщество

Ошибки