Skip to main content
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 passes onChangePage 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
Without 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

  1. Check with social.plus Support that auto-play is turned on for your network.
  2. Members pick up a change only at their next session: sign out and back in, or restart the app.
  3. Check the member’s own setting in profile → ⋯ → Settings → Autoplay in feed.
  4. On Android and iOS, check Data Saver or Low Data Mode, and on Wi-Fi only while on mobile data.
  5. Check that the screen is one where auto-play runs (Where auto-play runs).
Some browsers block auto-play entirely (for example Safari with Never Auto-Play, or Firefox with Block Audio and Video). When the browser refuses even muted playback, auto-play stays off for the session and every video shows its play button until the page reloads.
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.

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.