IKuznetsov: Новая страница: «= Настройка воспроизведения сеансов для iOS = На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''iOS'''. ЕдиныйАгент для '''iOS''' версии 8.323. Для приложений, скомпилированных с помощью '''Xcode''' 26, треб...»

2026-08-19T18:52:50Z

Новая страница: «= Настройка воспроизведения сеансов для iOS = На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''iOS'''. ЕдиныйАгент для '''iOS''' версии 8.323. Для приложений, скомпилированных с помощью '''Xcode''' 26, треб...»

Новая страница

= Настройка воспроизведения сеансов для iOS =

На этой странице описано, как активировать и настроить функцию '''Воспроизведения сессий''' для ваших приложений '''iOS'''.

ЕдиныйАгент для '''iOS''' версии 8.323. Для приложений, скомпилированных с помощью '''Xcode''' 26, требуется более поздняя версия.

== Используйте воспроизведение сессии ==

Функция '''Воспроизведение сессий''' на '''iOS''' позволяет записывать взаимодействие ваших клиентов с мобильным приложением и воспроизводить каждое касание, свайп и поворот экрана в режиме, напоминающем кинофильм.

Также его можно использовать для получения дополнительной информации для анализа сбоев в виде видеозаписей экрана, воспроизводящих действия пользователя, предшествовавшие обнаруженному сбою.

== Предварительные требования ==

Убедитесь, что ваша система соответствует следующим требованиям:

* Ключ-АСТРОМ версия 1.303.
* ЕдиныйАгент для '''iOS''', версия 8.323.
* Для вашего приложения активирован '''Мониторинг реального пользователя'''.
* Действующая лицензия '''Ключ-АСТРОМ Мониторинг цифрового опыта'''.
* '''Swift''' 5+.
* '''iOS''' 15+.
* '''Xcode''' 16+.
* Поддерживается '''SwiftUI'''.
* URL-адрес веб-интерфейса имеет доверенный сертификат.

== Известные ограничения и проблемы ==

* Поддерживается '''iOS''' 15.0 и выше.
* '''Swift''' 5+.
* '''Xcode''' 16+.
* Поддерживается '''SwiftUI'''.
* Функция '''Воспроизведение сессий''' недоступна для '''tvOS''' и '''iPadOS'''.
* Функция '''Воспроизведение сессий''' недоступна для кроссплатформенных фреймворков, таких как '''Cordova''', '''React Native''', '''Flutter''' и '''Xamarin'''.
* В гибридных приложениях функция '''Воспроизведение сессий''' поддерживается только для нативной части приложения. В браузерной части '''Воспроизведение сессий''' поддерживает только события загрузки веб-страницы.
* Мы не рекомендуем использовать другие инструменты для создания отчетов о сбоях одновременно с '''Воспроизведением сессий''' Ключ-АСТРОМ.
* Функция '''Воспроизведение сессий''' может фиксировать только определенные события. Однако, если вам необходимо отслеживать конкретное представление или событие, которое не поддерживается по умолчанию, вы можете фиксировать пользовательское событие.
* Воспроизведение пользовательских сессий, записанных с помощью функции '''Воспроизведение сессий''', возможно только в определенных браузерах.
* Для приложений '''iOS''' 26, созданных с помощью '''Xcode''' 26, функция маскирования доступна только с ЕдинымАгентом для '''iOS''' версии 8.323 и выше.
* Воспроизведение сессии — это видеоподобная реконструкция взаимодействия пользователя с мобильными приложениями, основанная на захваченных событиях и данных. Из-за такого подхода воспроизведенные сессии могут отличаться от реального пользовательского опыта.

== В iOS активируйте функцию воспроизведения сессий и отрегулируйте количество записанных сессий ==

Если вы еще этого не сделали, выполните все шаги, описанные в разделе первоначальной настройки для '''iOS'''-интерфейсов.

# Перейдите в раздел '''Ключевые показатели опыта''' > '''Обзор'''.
# Выберите '''Мобильные устройства''', чтобы просмотреть все мобильные версии сайта.
# Выберите интерфейс, который хотите настроить.
# Перейдите во вкладку '''Настройки'''.
# В рамках обеспечения возможностей и контроля затрат:
#* Включите '''классический режим мониторинга реальных пользователей''' или оба режима: '''классический''' и '''мониторинг реальных пользователей'''.
#* Выберите '''Воспроизведение сессий Classic''' или оба варианта: '''Воспроизведение сессий Classic''' и '''Воспроизведение сессий''', а затем введите новое значение коэффициента захвата для ценности воспроизведения сессии:
#** 100 процентов для учета всех сессий.
#** Процент, меньший чем 100 процентов, необходимый для захвата случайно выбранных сессий.
# Чтобы записывать все сессии со сбоями независимо от частоты записи, выберите '''Воспроизведение сессий для классических сбоев''' или оба варианта: '''Воспроизведение сессий для классических сбоев''' и '''Воспроизведение сессий для сбоев'''.
# В настройках приложения выберите '''Мастер инструментов''', а затем выберите '''iOS'''.
# Следуйте инструкциям мастера настройки приборов.

== Активировать воспроизведение сессий для приложений SwiftUI ==

ЕдиныйАгент для '''iOS''' версии 8.249+.

Если вы уже настроили поддержку своего приложения '''SwiftUI''', вы можете дополнительно активировать функцию '''Воспроизведения сессий''' для такого мобильного приложения.

Чтобы активировать функцию '''Воспроизведения сессий''' для вашего инструментированного приложения '''SwiftUI''':

# Выполните все шаги инструкции по активации воспроизведения сессии, описанной выше.
# Установите ключ конфигурации <code>DTXSwiftUIEnableSessionReplayInstrumentation</code> в значение <code>true</code> в файле <code>Info.plist</code> вашего проекта.
<pre>
<key>DTXSwiftUIEnableSessionReplayInstrumentation</key>
<true/>
</pre>

=== Поддерживаемые контейнеры SwiftUI ===

Мы поддерживаем '''Воспроизведение сессий''' для следующих контейнеров '''SwiftUI''':

* Список
* '''LazyVGrid'''
* '''LazyHGrid'''

=== Известные ограничения для приложений SwiftUI ===

Ключ-АСТРОМ не поддерживает следующие контейнеры '''SwiftUI''':

* Списки внутри расширений
* Списки со статическим содержимым
* Список случаев, когда объект кормления не соответствует протоколу '''Equatable'''.

== Скрыть конфиденциальные данные ==

=== Уровни маскирования данных ===

Функция '''Воспроизведение сессий''' имеет три предустановленных уровня маскировки:

* Наиболее безопасный вариант — все редактируемые текстовые поля, изображения, метки, веб-представления и переключатели скрыты.
* Безопасно — все редактируемые текстовые поля замаскированы.
* Пользовательский режим — по умолчанию маскирует те же элементы, что и '''Наиболее безопасный режим''', но вы можете точно определить, какие компоненты или представления приложения следует маскировать. Подробнее см. раздел «Настройка пользовательского маскирования».

=== Изменить уровень маскировки ===

По умолчанию ЕдиныйАгент применяет самый безопасный уровень маскирования. Чтобы изменить его на безопасный или пользовательский уровень, используйте API для настройки ЕдиногоАгента. Если вы выбрали пользовательский уровень, см. раздел «Настройка пользовательского маскирования» для получения подробной информации о том, как указать, какие компоненты или представления приложения должны быть замаскированы.

==== Пример 1: Измените уровень маскирования на «Безопасный» ====

Используйте следующий код, чтобы установить уровень маскирования на «Безопасный».

<pre>
let maskingConfiguration = MaskingConfiguration(maskingLevelType: .safe)
try? AgentManager.setMaskingConfiguration(maskingConfiguration)
</pre>

=== Настройка пользовательского маскирования ===

Если вы установите уровень маскирования данных на «Пользовательский», вы сможете использовать дополнительные методы API для определения того, какие компоненты или представления приложения следует маскировать. Вы сможете:

* Активировать или деактивировать правила маскирования.
* Маскировать представления с помощью <code>accessibilityIdentifier</code>.
* Маскировать изображения с помощью тега маскирования.

==== Активировать или деактивировать правила маскирования ====

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

<pre>
try? maskingConfiguration.add(rule: .maskAllImages) // Добавляет одно правило
try? maskingConfiguration.remove(rule: .maskAllSwitches) // Удаляет одно правило
try? maskingConfiguration.addAllRules() // Добавляет все правила
try? maskingConfiguration.removeAllRules() // Удаляет все правила
</pre>

Если удалить все правила маскирования, функция '''Воспроизведение сессий''' ничего не будет маскировать. Если активировать все правила маскирования, это будет эквивалентно самому безопасному уровню маскирования.

==== Маскирование изображений с помощью <code>accessibilityIdentifier</code> ====

Вы можете активировать или деактивировать маскирование выбранных представлений в зависимости от их параметров <code>accessibilityIdentifier</code>.

<pre>
try? maskingConfiguration.addMaskedView(viewIds: ["masked_view_id"])
try? maskingConfiguration.removeMaskedView(viewIds: ["masked_view_id"])
try? maskingConfiguration.addNonMaskedView(viewIds: ["nonMasked_view_id"])
try? maskingConfiguration.removeNonMaskedView(viewIds: ["nonMasked_view_id"])
</pre>

==== Маскируйте изображения с помощью тега маскирования ====

Также можно замаскировать представление, добавив тег <code>data-dtrum-mask</code> к его содержимому <code>accessibilityIdentifier</code>. Представление с этим тегом всегда будет замаскировано.

== Активировать журналы воспроизведения сеансов ==

Активировать журналы воспроизведения сессий можно так же, как и для ЕдиногоАгента. Дополнительную информацию см. в разделе «Отладка».

== Захват пользовательских событий ==

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

Все методы перехвата пользовательских событий могут выдавать ошибку <code>TrackCustomEventError.notInMainThread</code>, если вы попытаетесь перехватить пользовательское событие из потока, не являющегося основным. Мы рекомендуем добавить блок <code>do-catch</code> до тех пор, пока все не заработает должным образом; затем вы можете заменить этот блок более простой версией, которая, даже в случае ошибки, просто не будет перехватывать пользовательское событие.

<pre>
do {
try AgentManager.trackCustomEvent(name: "my_event_name", view: nil)
} catch {
print(error)
}
</pre>

=== Конкретный вид ===

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

<pre>
try? AgentManager.trackCustomEvent(name: "my_view_name", view: myView)
</pre>

=== Конкретная область экрана ===

Зафиксируйте пользовательское событие, сделав снимок экрана определенной области.

<pre>
try? AgentManager.trackCustomEvent(name: "my_view_name", frame: anyFrame)
</pre>

=== Полноэкранный ===

Зафиксируйте пользовательское событие, сделав снимок экрана в полном объеме.

<pre>
try? AgentManager.trackCustomEvent(name: "my_view_name")
</pre>

== Измените режим передачи изображений на Wi-Fi ==

По умолчанию все данные — информация о зафиксированных событиях и изображения — передаются по любому соединению. Однако вы можете выбрать передачу изображений только тогда, когда пользователи подключены к Wi-Fi, чтобы сэкономить мобильный трафик.

<pre>
AgentManager.setTransmissionMode(.wifi) // по умолчанию используется .data
</pre>

== Используйте отладчик скриншотов ==

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

При запуске мобильного приложения в симуляторе вы можете использовать отладчик скриншотов '''Воспроизведение сессий''', чтобы не ждать закрытия сессии и ее загрузки в Ключ-АСТРОМ.

После активации отладчика скриншотов '''Воспроизведение сессий''' вы сможете увидеть соответствующие ключи в своем проекте. Обратите внимание, что эти ключи не отправляются в код приложения при компиляции в релизную или архивную версии, поэтому они никогда не включаются в производственный код. Эти ключи используются только для отладочных запусков.

Чтобы активировать отладчик скриншотов воспроизведения сессии:

# В '''Xcode''' выберите пункт '''Изменить схему''' в меню '''Схема''', чтобы изменить схему вашего приложения.
# В настройках схемы приложения выберите действие '''Выполнить''', а затем перейдите на вкладку '''Аргументы'''.
# В разделе '''Переменные среды''' добавьте один или оба следующих ключа:
#* <code>DTXDebugMasking</code>. Этот ключ отображает скриншоты, сделанные функцией '''Воспроизведение сессий''', включая замаскированное содержимое и элементы управления пользовательского интерфейса. Для каждого сделанного скриншота вы увидите кратковременную вспышку.
#* <code>DTXDebugFrameHighlight</code>. Этот ключ выделяет захваченную часть экрана красной рамкой, чтобы вы могли точно определить, какая часть экрана была захвачена.

== Поиск неисправностей ==

* Пользовательские сессии вообще не записываются.
* Пользовательские сессии записываются, но функция воспроизведения сессии недоступна.

== Связанные темы ==

* Повтор сессии

Настройка воспроизведения сеансов для iOS - История изменений