Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка Платформы iAd Ссылка класса ADBannerView

Опции
Развертывание Target:

На этой странице
Язык:

ADBannerView

Наследование

Соответствует

Оператор импорта

Swift

import iAd

Objective C

@import iAd;

Доступность

Доступный в iOS 4.0 и позже.

ADBannerView класс обеспечивает представление что рекламные объявления баннера дисплеев пользователю. Когда пользователь касается представления баннера, представление инициировало действие, запрограммированное в рекламу. Например, реклама могла бы показать фильм, представить модальную рекламу или запустить Safari для показа веб-страницы. Когда действие запускается и останавливается, но иначе не взаимодействует с рекламой, Ваше приложение уведомляется. Когда пользователи видят новые рекламные объявления или инициировали их действия, Вы получаете доход.

Делегата представления баннера вызывают, когда представление баннера циклически повторяется для показа новой рекламы, а также когда пользователь взаимодействует с представлением баннера. Например, Ваш делегат обычно приостанавливает действия Вашего приложения, когда пользователь касается рекламы и восстанавливает те действия, когда пользователь заканчивает взаимодействовать с рекламой.

Представление баннера должно всегда использовать один из стандартных размеров, определенных в Идентификаторах Размера Содержания. Это должно гарантировать, что реклама составлена правильно. Вы конфигурируете представление баннера requiredContentSizeIdentifiers свойству с набором возможных размеров Ваше представление позволяют использовать в Вашем приложении. Для изменения размера представления баннера не устанавливайте границы непосредственно; вместо этого установите currentContentSizeIdentifier свойство к одному из идентификаторов размера включено в тот набор. Можно получить фактические размерности, к которым приравнивается определенный идентификатор на определенном устройстве путем вызова sizeFromBannerContentSizeIdentifier: метод класса.

Разделение на подклассы примечаний

ADBannerView класс обеспечивает автономное представление. Ваше приложение не должно разделять на подклассы ADBannerView, и при этом Ваше приложение не должно пытаться изменить поведение представления баннера. Например, Ваше приложение никогда не должно добавлять подпредставления к представлению баннера.

Управление типами объявления
  • init (adType:) - initWithAdType:

    Инициализирует представление баннера с указанным типом объявления.

    Объявление

    Swift

    init!(adType type: ADAdType)

    Objective C

    - (instancetype)initWithAdType:(ADAdType)type

    Параметры

    type

    Тип баннера просматривает для конфигурирования получателя как.

    Возвращаемое значение

    Недавно сконфигурированное представление баннера указанного типа объявления.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 6.0 и позже.

  • adType Свойство

    Тип объявления представления баннера.

    Объявление

    Swift

    var adType: ADAdType { get }

    Objective C

    @property(nonatomic, readonly) ADAdType adType

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 6.0 и позже.

Установка и получение делегата
  • delegate Свойство

    Делегат представления баннера.

    Объявление

    Swift

    weak var delegate: ADBannerViewDelegate!

    Objective C

    @property(nonatomic, weak) id< ADBannerViewDelegate > delegate

    Обсуждение

    Делегат представления баннера уведомляется, когда события, связанные с представлением баннера и текущим объявлением, имеют место, такой как тогда, когда новое объявление загружается, когда ошибки происходят, в то время как выбирающие объявления, или когда действия баннера начинаются и заканчиваются.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    ADBannerViewDelegate

Конфигурирование распространения, показанного в представлении баннера
  • advertisingSection Свойство

    Зарезервированный для будущего использования.

    Объявление

    Swift

    var advertisingSection: String!

    Objective C

    @property(nonatomic, copy) NSString *advertisingSection

    Обсуждение

    Это свойство резервируется для будущего использования.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 4.0 и позже.

Изменение размеров (осуждаемого) представления баннера
  • requiredContentSizeIdentifiers (iOS 6.0) Свойство

    Ряд идентификаторов для размеров рекламных объявлений, которые может вывести на экран представление баннера.

    Оператор осуждения

    Представления баннера больше не используют идентификаторы размера содержания. Посмотрите Идентификаторы Размера Содержания для подробных данных.

    Объявление

    Objective C

    @property(nonatomic, copy) NSSet *requiredContentSizeIdentifiers

    Обсуждение

    Представления баннера должны всегда иметь размерности, соответствующие размер известного рекламного формата. Ваше приложение устанавливает requiredContentSizeIdentifiers свойство так, чтобы представление баннера могло загрузить рекламные объявления, обеспечивающие иллюстрации для тех размеров. Известные размеры перечислены в Идентификаторах Размера Содержания. Значение по умолчанию является набором включая обоих ADBannerContentSizeIdentifierPortrait и ADBannerContentSizeIdentifierLandscape.

    Если набор включает единственный идентификатор, то рекламные объявления, загруженные представлением баннера, имеют изображение баннера с тем размером. Если набор включает многократные идентификаторы, рекламные объявления, загруженные представлением баннера, включают изображения для всех размеров, указанных в наборе. Это позволяет представлению баннера быть измененным, не имея необходимость загружать дополнительные изображения. Не включайте идентификаторы для размеров, которые не использует Ваше приложение, поскольку оно может излишне ограничить материально-технические ресурсы рекламных объявлений, доступных Вашему приложению.

    Установка requiredContentSizeIdentifiers свойство не изменяет размеры представления баннера. Для изменения размера представления баннера приложение устанавливает currentContentSizeIdentifier свойство.

    Оператор импорта

    Objective C

    @import iAd;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    currentContentSizeIdentifier

  • currentContentSizeIdentifier (iOS 6.0) Свойство

    Строка, идентифицирующая текущий размер рекламы, выведенной на экран в представлении баннера.

    Оператор осуждения

    Представления баннера больше не используют идентификаторы размера содержания. Посмотрите Идентификаторы Размера Содержания для подробных данных.

    Объявление

    Objective C

    @property(nonatomic, copy) NSString *currentContentSizeIdentifier

    Обсуждение

    Ваше приложение никогда не должно непосредственно изменять размер представления баннера. Вместо этого установите currentContentSizeIdentifier свойство к известному рекламному размеру. Представление автоматически изменено для соответствия нового размера содержания. Значение по умолчанию ADBannerContentSizeIdentifierPortrait.

    Идентификатор поместил в currentContentSizeIdentifier свойство должно быть включено в набор идентификаторов, сохраненных в requiredContentSizeIdentifiers свойство. Это гарантирует, что реклама, выведенная на экран представлением, может все еще быть выведена на экран после того, как размер представления изменяется. Установка значения, не включенного в requiredContentSizeIdentifiers свойство заставляет исключение быть брошенным.

    Оператор импорта

    Objective C

    @import iAd;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    requiredContentSizeIdentifiers

  • + sizeFromBannerContentSizeIdentifier: (iOS 6.0)

    Преобразовывает идентификатор размера содержания баннера в его физический размер.

    Оператор осуждения

    Представления баннера больше не используют идентификаторы размера содержания. Посмотрите Идентификаторы Размера Содержания для подробных данных.

    Объявление

    Objective C

    + (CGSize)sizeFromBannerContentSizeIdentifier:(NSString *)contentSizeIdentifier

    Параметры

    contentSizeIdentifier

    Строка, идентифицирующая размер содержания баннера. Посмотрите Идентификаторы Размера Содержания для возможных значений.

    Возвращаемое значение

    Размерности того размера содержания в точках.

    Обсуждение

    Возвращаемое значение отличается на основе устройства, на котором работает Ваше приложение.

    Оператор импорта

    Objective C

    @import iAd;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

Определение, показывает ли Представление Баннера Рекламу
  • bannerLoaded Свойство

    Булево значение, утверждающее, загрузило ли представление баннера рекламу. (только для чтения)

    Объявление

    Swift

    var bannerLoaded: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isBannerLoaded) BOOL bannerLoaded

    Обсуждение

    Представления баннера автоматически загружают новые рекламные объявления в фоновом режиме. Это свойство возвраты YEStrue если загружается реклама; NOfalse иначе.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 4.0 и позже.

Действия баннера
  • bannerViewActionInProgress Свойство

    Булево значение, утверждающее, выполняет ли баннер в настоящее время инициированное пользователями действие. (только для чтения)

    Объявление

    Swift

    var bannerViewActionInProgress: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isBannerViewActionInProgress) BOOL bannerViewActionInProgress

    Обсуждение

    Рекламные объявления имеют действие, инициированное, когда пользователь касается баннера. Некоторые действия остаются в приложении, покрывая пользовательский интерфейс приложения, пока не завершается действие. Значение этого свойства YEStrue когда работает такое действие; иначе это NOfalse.

    Ваше приложение должно избежать опрашивать это свойство. Вместо этого реализуйте методы делегата обнаружить, когда действие начнется или закончится.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 4.0 и позже.

  • cancelBannerViewAction () - cancelBannerViewAction

    Отменяет выполняющееся действие представления баннера.

    Объявление

    Swift

    func cancelBannerViewAction()

    Objective C

    - (void)cancelBannerViewAction

    Обсуждение

    Действие представления баннера может покрыть пользовательский интерфейс Вашего приложения. Однако Ваше приложение продолжает работать и обычно получает события. Если Ваше приложение получает событие, требующее внимания пользователя, оно может программно отменить действие и раскрыть его интерфейс путем вызова cancelBannerViewAction. Отмена действий часто может вызывать потерю дохода для Вашего приложения.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 4.0 и позже.

Типы данных

  • ADError

    Коды ошибки для iAd ошибочного домена.

    Объявление

    Swift

    enum ADError : Int { case Unknown case ServerFailure case LoadingThrottled case InventoryUnavailable case ConfigurationError case BannerVisibleWithoutContent case ApplicationInactive case AdUnloaded }

    Objective C

    typedef enum : NSInteger { ADErrorUnknown = 0, ADErrorServerFailure = 1, ADErrorLoadingThrottled = 2, ADErrorInventoryUnavailable = 3, ADErrorConfigurationError = 4, ADErrorBannerVisibleWithoutContent = 5, ADErrorApplicationInactive = 6 ADErrorAdUnloaded = 7, } ADError;

    Константы

    • Unknown

      ADErrorUnknown

      Указывает, что произошла неизвестная или неожиданная ошибка.

      Доступный в iOS 4.0 и позже.

    • ServerFailure

      ADErrorServerFailure

      Указывает что соединение с отказавшим сервером рекламных объявлений.

      Доступный в iOS 4.0 и позже.

    • LoadingThrottled

      ADErrorLoadingThrottled

      Указывает, что в настоящее время регулируют загрузку с сервера рекламных объявлений.

      Доступный в iOS 4.0 и позже.

    • InventoryUnavailable

      ADErrorInventoryUnavailable

      Указывает, что никакие рекламные объявления не в настоящее время доступны загрузке.

      Доступный в iOS 4.0 и позже.

    • ConfigurationError

      ADErrorConfigurationError

      Указывает, что Ваше приложение не было сконфигурировано для получения рекламных объявлений. Проверьте конфигурацию своего приложения на Подключении iTunes. Когда Ваше приложение работает в Песочнице, эта ошибка не получена.

      Доступный в iOS 4.0 и позже.

    • BannerVisibleWithoutContent

      ADErrorBannerVisibleWithoutContent

      Указывает, что баннер видим, но не показана никакая реклама. Ваше приложение должно всегда скрывать баннер, когда это не имеет рекламы для отображения.

      Доступный в iOS 4.0 и позже.

    • ApplicationInactive

      ADErrorApplicationInactive

      Указывает, что содержание объявления не доступно, потому что приложение не в настоящее время активно.

      Доступный в iOS 4.0 и позже.

    • AdUnloaded

      ADErrorAdUnloaded

      Объявление, выводимое на экран в баннере, было разгружено. Это могло бы произойти, когда объявление истекает или когда объявление перемещено от невидимого баннера до видимого баннера.

      Доступный в iOS 4.0 и позже.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 4.0 и позже.

Константы
  • Идентификаторы размера содержания

    Эти строки используются для идентификации размера рекламы.

    Объявление

    Objective C

    extern NSString * const ADBannerContentSizeIdentifier320x50; extern NSString * const ADBannerContentSizeIdentifier480x32; extern NSString * const ADBannerContentSizeIdentifierPortrait; extern NSString * const ADBannerContentSizeIdentifierLandscape;

    Константы

    • ADBannerContentSizeIdentifier320x50

      Указывает, что представление баннера является 320 точками 50 точками в размере. Этот размер используется на iPhone для рекламных объявлений портрета.

      Доступный в iOS 4.0 и позже.

      Осуждаемый в iOS 4.2.

    • ADBannerContentSizeIdentifier480x32

      Указывает, что представление баннера является 480 точками 32 точками в размере. Этот размер используется на iPhone для альбомных рекламных объявлений.

      Доступный в iOS 4.0 и позже.

      Осуждаемый в iOS 4.2.

    • ADBannerContentSizeIdentifierPortrait

      Указывает, что представление баннера находится в portait режиме. Точный размер представления portait зависит от устройства на iOS, на котором выведена на экран реклама. На iPhone баннер портрета является 320 точками 50 точками в размере. На iPad баннер портрета является 768 точками 66 точками в размере.

      Доступный в iOS 4.2 и позже.

      Осуждаемый в iOS 6.0.

    • ADBannerContentSizeIdentifierLandscape

      Указывает, что представление баннера находится в альбомном режиме. Точный размер представления зависит от устройства на iOS, на котором выведена на экран реклама. На iPhone альбомный баннер является 480 точками 32 точками в размере. На iPad альбомный баннер является 1 024 точками 66 точками в размере.

      Доступный в iOS 4.2 и позже.

      Осуждаемый в iOS 6.0.

  • ADErrorDomain

    Эта константа определяет iAd ошибочный домен платформы.

    Объявление

    Swift

    let ADErrorDomain: String

    Objective C

    extern NSString * const ADErrorDomain;

    Константы

    • ADErrorDomain

      Указывает, что ошибка произошла в iAd.

      Доступный в iOS 4.0 и позже.

  • ADAdType

    Константы, указывающие типы объявлений.

    Объявление

    Swift

    enum ADAdType : Int { case Banner case MediumRectangle }

    Objective C

    typedef enum : NSInteger, ) { ADAdTypeBanner, ADAdTypeMediumRectangle } ADAdType;

    Константы

    • Banner

      ADAdTypeBanner

      Рекламный баннер ширины устройства.

      Высота баннера меняется в зависимости от типа устройства и ориентации следующим образом:

      Идиома UI и ориентация

      Высота объявления

      телефон, портрет

      50 точек

      телефон, среда

      32 точки

      клавиатура, портрет или среда

      66 точек

      Доступный в iOS 6.0 и позже.

    • MediumRectangle

      ADAdTypeMediumRectangle

      Только для клавиатуры 320x250 указывает на объявление, на основе Бюро Международной рекламы «Средний прямоугольник» Интерактивный Маркетинговый Модуль.

      Доступный в iOS 6.0 и позже.

    Оператор импорта

    Objective C

    @import iAd;

    Swift

    import iAd

    Доступность

    Доступный в iOS 6.0 и позже.