Key Benefit: When feed videos wait for a tap, members scroll past them as thumbnails, and the feed feels static next to the social apps they use every day. With auto-play on, the most visible video plays in place, muted, so members can judge a video in a second or two without being caught out by sound. Your video and live posts get watched instead of scrolled past, and one tap takes members into the full player, already playing, with no feed or player code to write.
Platform Support: Feed video auto-play is available on the iOS, Android and React Web UIKit: Android UIKit 4.35.0 and Web UIKit 4.28.0 or later. It is not available on Flutter or React Native.
Feature Overview
Feed video auto-play is built into the UIKit’s post components. Once it’s turned on for your network, every supported feed plays videos automatically: there is nothing to add to your screens. Members can choose when it runs for themselves, and it can be turned off for the whole network at any time.Plays in place
The most visible video starts as soon as it is at least half on screen, muted. One video plays at a time.
One sound setting
Videos start muted. One unmute applies to every later video in the session, including the full player.
Resume and replay
Each video resumes where it stopped. It plays once and ends on its last frame with Watch again.
Member control
Members choose when auto-play runs. The network switch applies to everyone.
How It Works
Auto-play runs only when both of these allow it. Neither one outranks the other: if either is off, nothing auto-plays.
When both allow it, the UIKit behaves like this:
Feed previews of live and recorded live posts are not counted as views, and the member does not join the host’s viewer list. Counting starts when the member opens the live player.
Where Auto-play Runs
Video, clip, live and recorded live posts all auto-play, including videos inside a carousel: swiping to a video page plays it.
Turn It On for Your Network
Auto-play is off by default. To turn it on for your network, contact social.plus Support. Members’ apps pick up the change the next time they sign in or the app starts.Member Setting
Members open their own profile → ⋯ menu → Settings → Autoplay in feed. The row shows the current choice. Visitors and bots don’t see the row and always count as on.- A choice is saved as soon as it’s made. On Android and iOS, tapping outside the sheet closes it.
- With nothing saved, auto-play is on: on Wi-Fi and mobile data on Android and iOS, On on Web.
- The choice is saved on the device (in the browser on Web), not per user. It carries over to whoever signs in next on that device or browser.
- On Android and iOS, Data Saver (Android) and Low Data Mode (iOS) also stop auto-play.
- The network switch off overrides any member choice.
Web offers a single On/Off switch because browsers can’t reliably tell Wi-Fi from mobile data. Web doesn’t check the connection type or the browser’s data saver, so On auto-plays on any connection.
Web: The Setting Page with Your Own Navigation
If your web app passesonChangePage to AmityUiKitProvider to handle navigation itself, the Autoplay in feed row sends { type: 'AutoplaySettingPage' } instead of opening the page. Render AmityAutoplaySettingPage for that type. It takes no props.
React
onChangePage, the UIKit opens the page itself and you don’t need any code.
Customization
Feed video auto-play has no config IDs on Android or iOS, and none for the feed video on Web: the video, its sound button and Watch again can’t be hidden or themed through config, so auto-play can’t be turned off for a single screen. To turn it off for your network, contact social.plus Support. The Web setting page has a page ID, like other Web pages:Troubleshooting
Videos don't auto-play
Videos don't auto-play
- Check with social.plus Support that auto-play is turned on for your network.
- Members pick up a change only at their next session: sign out and back in, or restart the app.
- Check the member’s own setting in profile → ⋯ → Settings → Autoplay in feed.
- On Android and iOS, check Data Saver or Low Data Mode, and on Wi-Fi only while on mobile data.
- Check that the screen is one where auto-play runs (Where auto-play runs).
Web: the first video plays muted after the member turned sound on
Web: the first video plays muted after the member turned sound on
Some browsers won’t play sound without a fresh tap. The video then plays muted and its sound button shows muted; the member’s next tap turns the sound back on.
Related Components
Social Feeds
The feeds and home page where auto-play runs.
Video Post (SDK)
Read the auto-play setting when you build your own video UI.
Localization
Override UIKit text, including auto-play’s, in any language.