How does a brand customize the Genuin video player controls?
Why does this matter?
The video player is one of the most important interaction points inside a Community Media Network. Customizing the player experience allows brands to align video playback with their app experience, engagement goals, and user journey.
With customizable video player controls, brands can:
- Deliver a more branded and immersive experience
- Improve content discoverability and engagement
- Optimize viewing experiences across web and app
- Control how users interact with video content
- Support personalized navigation and deep linking journeys
- Improve retention and watch time
The Genuin SDK provides flexible configuration options for feed embeds, carousel embeds, and full-screen video experiences.
What can brands customize in the Genuin video player?
Brands can configure several video player behaviors and interaction settings within SDK embeds and feed experiences.
Supported customization areas include:
| Customization Area | Purpose |
|---|---|
| Full-screen playback | Control immersive viewing experiences |
| Profile visibility | Display or hide user profile access |
| Deep linking behavior | Redirect users to app or specific content |
| Interaction redirection | Route clicks to custom destinations |
| Embed dimensions | Customize player layout and sizing |
| Feed experience | Configure carousel or standard feed views |
| SSO-based personalization | Deliver authenticated experiences |
| Navigation flow | Control how users move across content |
How do I customize the video player using the Flutter SDK?
Choose the video experience type
The SDK supports:
- Feed View
- Carousel Embed View
- Full-Screen / Standard Wall Embed View
How do I customize a carousel video player?
Use the GenuinCarouselEmbedView.
SizedBox(
height: 400,
width: MediaQuery.of(context).size.width,
child: const GenuinCarouselEmbedView(
embedId: "YOUR_EMBED_ID",
uniqueId: "UNIQUE_ID",
ssoToken: "YOUR_SSO_TOKEN",
interactionDeepLink: "YOUR_DEEP_LINK",
isShowProfileEnabled: true,
isDirectDeepLinkEnabled: false,
),
)How do I customize a full-screen video player?
Use the GenuinFeedEmbedView.
SizedBox(
height: MediaQuery.of(context).size.height,
width: MediaQuery.of(context).size.width,
child: const GenuinFeedEmbedView(
embedId: "YOUR_EMBED_ID",
uniqueId: "UNIQUE_ID",
ssoToken: "YOUR_SSO_TOKEN",
interactionDeepLink: "YOUR_DEEP_LINK",
isShowProfileEnabled: true,
isDirectDeepLinkEnabled: false,
),
)What do the video player configuration parameters control?
embedId
Defines which video feed or embed experience should load.
embedId: "YOUR_EMBED_ID"uniqueId
Used when displaying the same embed multiple times on a screen.
uniqueId: "UNIQUE_ID"This helps maintain proper rendering and tracking behavior.
ssoToken
Automatically authenticates users inside the SDK experience.
ssoToken: "YOUR_SSO_TOKEN"This enables:
- Personalized feeds
- Community participation
- User-specific recommendations
- Profile visibility
interactionDeepLink
Redirects interactions to a custom app screen or URL.
interactionDeepLink: "YOUR_DEEP_LINK"When configured:
- Video interactions redirect users externally
- Brands can control conversion journeys
- Users can move into product pages, campaigns, or app destinations
The URL must be valid. Invalid links may prevent redirection.
isDirectDeepLinkEnabled
Controls whether users open the exact content inside the white-labeled app.
isDirectDeepLinkEnabled: trueWhen enabled:
- Users open the associated video directly
- Deep linking bypasses generic redirects
- Content opens inside the connected white-labeled experience
Requirements
To use this feature, brands must:
- Configure a white-labeled domain
- Implement deep-link handling in the host application
isShowProfileEnabled
Controls visibility of the user profile option inside the player.
isShowProfileEnabled: trueWhen enabled and the user is authenticated:
- Profile image appears in the player
- Users can access account settings
- Logout options become available
How do brands customize player sizing and layout?
The player layout can be controlled using Flutter containers and sizing components.
Example:
SizedBox(
height: 400,
width: MediaQuery.of(context).size.width,
)Brands can configure:
- Fixed-height carousels
- Full-screen feeds
- Embedded player walls
- Responsive layouts
- In-app content sections
How does deep linking improve the video experience?
Deep linking helps create a seamless user journey between content experiences and branded destinations.
Brands can use deep linking to:
- Open specific videos directly
- Redirect users into native app screens
- Support white-labeled app navigation
- Drive users into commerce or campaign journeys
- Improve content continuity across devices
How does SSO improve video player personalization?
SSO authentication enables personalized experiences inside the player.
This allows brands to:
- Auto-login users
- Deliver customized recommendations
- Show personalized feeds
- Enable community participation
- Preserve user sessions across experiences
How do brands optimize engagement using video player controls?
Brands can improve engagement by configuring:
| Strategy | Benefit |
|---|---|
| Full-screen playback | Increases immersion and watch time |
| Personalized feeds | Improves content relevance |
| Deep-linked interactions | Creates smoother conversion journeys |
| Profile-enabled experiences | Encourages participation |
| Carousel embeds | Improves discoverability |
| Community-based feeds | Strengthens retention |
Best Practices
- Use full-screen feeds for immersive storytelling
- Enable SSO for personalized engagement
- Configure direct deep linking for white-labeled apps
- Use carousel embeds for homepage discovery sections
- Keep player layouts responsive across devices
- Test interaction flows before publishing
- Use unique IDs when rendering multiple embeds
Specs & Limitations
| Area | Details |
|---|---|
| Supported SDKs | Flutter SDK |
| Supported Experiences | Feed, Carousel, Full-Screen Embed |
| Authentication | Supports SSO |
| Deep Linking | Supported |
| Direct Deep Linking | Requires white-labeled domain |
| Profile Visibility | Requires authenticated users |
| Layout Control | Managed through Flutter widgets |
| Mobile Orientation | Portrait supported |
| Multiple Embed Support | Requires uniqueId values |
| Push Notification Integration | Supported separately |
Example Use Cases
Community Video Experience
Brands can launch full-screen immersive community feeds inside their mobile apps.
Commerce Discovery
Carousel players can highlight product videos and redirect users into shopping journeys.
Creator Communities
Profile-enabled video players encourage creator engagement and user participation.
Campaign Activation
Deep-linked video interactions can route users directly into promotional campaigns or branded experiences.