Video commerce in your Android app.

Pin an approved package. Create one player for one screen.

1. Add the package. Get the private Maven address and credentials from Live Market. Keep them in the host's approved secret store. Pin the exact approved version.
2. Configure one environment. Supply a client ID and content token. Add a separate collector token only when the host enables analytics.
3. Connect the cart. Set cartHandler before load. For a placement without products, set videoOnly = true.
4. Bind the view. Use LiveMarketPlayerView in Views or LiveMarketPlayerHost in Compose.
5. Own the lifecycle. Use the main thread for player and view calls. Pause when the screen stops. Call destroy() when the screen ends.

dependencies {
    implementation("market.live:live-market-sdk:<approved-version>")
}

val configuration = LiveMarketSDKConfiguration(
    environment = LiveMarketEnvironment.STAGING,
    business = LiveMarketBusiness(clientId, contentToken, collectorToken),
    cartMode = LiveMarketCartMode.MESSAGE,
    analytics = LiveMarketAnalyticsConfiguration.DISABLED
)
val player = LiveMarketPlayer(context, configuration)
player.cartHandler = hostCartHandler
player.load(LiveMarketSelection(placementTag), LiveMarketPresentation.GRID)

The host supplies context, credentials, placementTag, and hostCartHandler. Set analytics to ENABLED only after you connect the host consent flow. The full guide shows the private Maven repository setup and lifecycle examples.

Native SDK code reviews service data before it shows a video. The bundled renderer has fixed WebView settings.

The SDK fixes the content route, renderer, and resource policy for each environment. It rejects unapproved URLs and invalid content. It checks the renderer baseline and asset digests before it creates a WebView. The SDK sends analytics in native code. The embedded page does not send duplicate analytics.

A new load cancels the old generation. A new item cancels old media and cart work. A late callback cannot change the active item. The host keeps credentials, cart destinations, and checkout outside the SDK.

Use one immutable configuration for one client and environment.

Keep tokens out of source, logs, diagnostics, and WebView data. A mobile app user can inspect an app-owned token. Use limited mobile authority and a service process for rotation and revocation.

FEED shows one active video with next and previous controls. It needs a carousel or grid component with at least two videos. Call load(selection) to use the validated server component. Call load(selection, presentation) to require one surface. Use startingAt to open a feed at a loaded index.

Carousel and grid lists do not play before a video opens. A selected video starts muted playback when it opens in the foreground. Call selectItem(index) for a loaded video. Call closeActiveItem() to close an open carousel or grid video and pause it.

Fullscreen playback

Tap a carousel or grid card to open fullscreen playback. Swipe left for the next video. Swipe right for the previous video. The list does not wrap at either end. Fullscreen stays open when the video changes.

At the end of the loaded grid videos, a forward swipe requests the next page. The current video stays open while the SDK reviews that page. The SDK opens the next video only after review succeeds. Swipe again after a failed page request to retry.

Swipe up or down to close playback and return to the same list position. The inward corner icon and Android Back also close the video. Closing a carousel or grid video pauses playback. Swipes that start on playback or product controls keep their control behavior.

Single video uses a manual fullscreen toggle. Exit returns it to inline playback. Feed uses its own video navigation. The unused inline space is transparent. The bridge stays mounted without an HTML video poster. The fullscreen background is black.

The SDK validates the selected product and variant. The host app changes the cart.

Set cartHandler before load. The handler gets a typed LiveMarketCartRequest. It includes the request ID, selected product and variant, quantity, mode, and an opaque cart parameter. Treat requestId as an idempotency key. Apply each cart change at most once.

The SDK waits up to 15 seconds for a result. It cancels old work when a load or item changes. Return Accepted only after the cart accepts the item. Use Rejected when it does not. Cart acceptance does not mean checkout or payment succeeded.

The host owns the consent decision. Analytics stays off by default.

1. Configure. Set analytics = LiveMarketAnalyticsConfiguration.ENABLED. Supply a collector token that differs from the content token.
2. Grant. Call grantAnalyticsConsent(userId) after the shopper agrees.
3. Update. Call denyAnalyticsConsent() when consent ends. Use identity and session methods when the host identity changes.
4. Reload. Load the placement again after a consent or identity change to start new attribution.

Native events use the pinned shared contract's schema_version=1.8.0, sdk_name=android, and channel=mobile_app. The host must arrange service deletion for events that the collector already accepted.

Call player methods and manage the view on the main thread.

Player and views

Values and diagnostics

Use LiveMarketPlayerListener.onPlayerChanged(player) for updates. A LiveMarketPlaybackState.Failed value has a bounded error message. Show Retry when the operation can retry.

The repository includes a client integration skill for agent work in a host app. Copy its folder and references/ directory to the client's agent workspace. Check the approved SDK version and its public guide before each use. The skill covers all four presentations, all three cart modes, consent, lifecycle, and staging checks.

Keep Android System WebView current. Set android:usesCleartextTraffic="false" or use an equally strict network security configuration. Check the merged app manifest for unexpected dangerous permissions and com.google.android.gms.permission.AD_ID.

Test fullscreen entry, next and previous videos, grid page loading, and each close action in the host app. Check that closing playback keeps the list position. Check playback and product gestures. Check that leaving the screen pauses playback.

Run the SDK and host unit tests and the host Debug build from the sibling android-poc repository. API 31 and API 36 emulator checks do not prove physical-device, performance, or TalkBack behavior. See the full guide and README for setup details.