---
title: "Picture in Picture"
slug: "vpe-picture-in-picture"
updated: 2026-09-17T09:22:39Z
published: 2026-09-17T09:22:39Z
canonical: "guide.ncloud-docs.com/vpe-picture-in-picture"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Picture in Picture

Available in Classic and VPC

This page explains how to configure Picture in Picture settings for the player.

              Caution

              

This feature only works on physical devices. It does not work on simulators.

              Note

              

This applies to both Android and iOS.

## allowsPictureInPicture

PIP implementation requires the autoPause option.

```
const playerRef = useRef(null);
return (
  <VpePlayer
      ...
      ref={playerRef}
      options={{
            playlist: [ //Playback source
                {
                    file: 'https://CDNdomain/example_video_01.mp4'
                },
            ],
            autoPause: false, //false: Enable background playback
            allowsPictureInPicture: true, //Enable PIP
          }}
      ...
  />

)
```

## app.json configuration

To support the Picture-in-Picture feature, you must add the relevant options. You must add options to use the background play feature.

```
{
  "expo": {
    ...
    "plugins": [
       ...
        [
            "@sgrsoft/react-native-video",
            {
                "enableAndroidPictureInPicture": true
            }
        ]
    ],
    "ios": {
      ...
      "infoPlist": {
        "UIBackgroundModes": [
            "audio",
            "fetch"
        ]
      }
      ...
    },
    "android": {
      ...
      "edgeToEdgeEnabled": true,
      "supportsPictureInPicture": true,
      "permissions": [
            "android.permission.FOREGROUND_SERVICE"
      ]
      ...
    },
  }
}
```

              Caution

              

You may need to run prebuild or pod install depending on the situation.