Do you build things with AMP? Fill out the AMP Developer Survey!
AMP
EN
Deutsch Français العربية Español Italiano Indonesia 日本語 한국어 Português Русский Türkçe 中文 Polski Tiếng việt
  • websites

amp-google-vrview-image

Experimental

This example uses the following experimental feature: amp-google-vrview-image. Enable the experiment via the button below. Some components require the AMP Dev Channel to be enabled as well. Learn more about experimental features.

View demo Open in playground

Introduction

The amp-google-vrview-image extension allows embedding 360 degree VR media into AMP pages.

If experimenting with this sample on a desktop web browser, you can interact with the displayed image by clicking on it and dragging the mouse around. The best way to perceive the effects enabled by this component is to view it on a mobile device and interact with the images by moving the device around using the cardboard viewer.

The attributes supported by this component are:

  • src: the source of the image being displayed
  • stereo: if provided, the image is considered to be a stereoscopic image; otherwise it is a monoscopic image.
  • yaw: initial yaw rotation of the viewer
  • yaw-only: if specified, restrict motion to yaw rotations only

Setup

Import the amp-google-vrview-image component in the header.

<script async custom-element="amp-google-vrview-image" src="https://cdn.ampproject.org/v0/amp-google-vrview-image-0.1.js"></script>

Basic usage

By default amp-google-vrview-image expects a mono image and the yaw value is 0.

<amp-google-vrview-image src="https://storage.googleapis.com/vrview/examples/coral.jpg"
  width="400"
  height="300"
  layout="responsive">
</amp-google-vrview-image>

Stereo

Add the stereo attribute for stereoscopic images

<amp-google-vrview-image src="https://storage.googleapis.com/vrview/examples/coral.jpg"
  stereo
  width="400"
  height="300"
  layout="responsive">
</amp-google-vrview-image>

Yaw

Add the stereo attribute for stereoscopic images. The initial yaw value is 90 degrees

<amp-google-vrview-image src="https://storage.googleapis.com/vrview/examples/coral.jpg"
  stereo
  yaw="90"
  width="400"
  height="300"
  layout="responsive">
</amp-google-vrview-image>

Yaw-only

Use the yaw-only attribute to restrict motion to the yaw axis only

<amp-google-vrview-image src="https://storage.googleapis.com/vrview/examples/coral.jpg"
  stereo
  yaw-only
  width="400"
  height="300"
  layout="responsive">
</amp-google-vrview-image>
Need further explanation?

If the explanations on this page don't cover all of your questions feel free to reach out to other AMP users to discuss your exact use case.

Go to Stack Overflow
An unexplained feature?

The AMP project strongly encourages your participation and contributions! We hope you'll become an ongoing participant in our open source community but we also welcome one-off contributions for the issues you're particularly passionate about.

Edit sample on GitHub