# Web SDK: методы и lifecycle Для первого подключения используйте [Web SDK](). Здесь собран контракт методов основного bundle. ## Методы основного SDK Параметр SDK `clientId` принимает тот же идентификатор проекта, который в Public API называется `applicationId`. Используйте значение, выданное ShopStory, без преобразований. Общие правила: [Идентификаторы](). ### show Монтирует каталог в контейнер сайта. Возвращает `undefined` (тип `void`), не предоставляет Promise загрузки каталога. | Параметр | Обязательно | Назначение | | --- | --- | --- | | `containerElement` | Да | Существующий DOM-элемент, который сайт сохраняет на время работы SDK | | `config.clientId` | Да | Строковый идентификатор проекта, выданный ShopStory | | `actions` | Нет | Обработчики [добавления товара в корзину]() и [проверки наличия]() для этого экземпляра | | `cartUrl` | Нет | Адрес корзины для повторного клика по состоянию «В корзине»; относительный путь разрешается от origin сайта | `await ShopStorySDK.show(...)` не ждёт каталог. Ограничения повторной инициализации описаны в разделе [SPA и lifecycle](). ### showPlayer Открывает указанную трансляцию в собственном контейнере в `document.body`. При первом вызове SDK создаёт контейнер, при следующих использует его повторно. Оба параметра обязательны: | Параметр | Тип | Назначение | | --- | --- | --- | | `clientId` | `string` | Идентификатор проекта | | `streamId` | `string` | Идентификатор трансляции из API | Возвращает `Promise`. Promise завершается после внутренней инициализации SDK, ещё до подтверждения загрузки данных эфира и воспроизведения видео. Использовать его как сигнал «видео готово» нельзя. show-player.js ```javascript async function openShopStoryPlayer(streamId) { const sdk = window.ShopStorySDK; if (!sdk) { console.error('Основной bundle ShopStory не загружен'); return; } try { await sdk.showPlayer({ clientId: 'assigned-application-id', streamId, }); } catch (error) { console.error('Не удалось вызвать плеер ShopStory', error); } } ``` Передавайте идентификаторы строками. Список трансляций для собственного интерфейса получайте через [`GET /v3/streams`](). `showPlayer()` не принимает `actions` и `cartUrl` и не наследует их из ранее вызванного `show()`. Для прямой корзины используйте плеер внутри каталога, созданного через `show({ actions, ... })`, либо согласованный commerce-контракт. ### Готовность и ошибки У основного SDK нет публичных событий или параметров `onReady` / `onError` для загрузки каталога и плеера. Событие `load` у `