When and Why to Use

Use this to present a video stimulus, optionally with a live dial for feedback. It's best for:

• Ad or creative testing
• Comprehension and recall studies
• Real-time sentiment capture via dial testing

Videos are DRM-protected and watermarked for security. Playback links expire after 60 seconds.

Chat Experience

• Video fills most of the screen with start and end messages above and below
• If dial is enabled, it appears beneath or to the side depending on configuration

Traditional Experience

• Video plays fullscreen or centered
• Dial, if used, appears on the right or bottom with live interaction enabled
• Remote or keyboard users can operate playback and dial

Dial Testing

The dial appears to the side or below the video, and is always displayed in full screen, if available.

Configuration Options

Option	Type	Required	Default	Description
video	MediaItem	yes	-	Video to play from s.media
start_message	str	no	"Hit play when you're ready to watch..."	Message shown before video begins
end_message	str	no	"Thank you for watching the video!"	Message shown after video ends
dial	str	no	"none"	"none", "right", or "bottom" for dial placement
start_position	int	no	The center of the dial	The dial start position
dial_labels	Dict[int, str]	no	{0: "Dislike", 50: "Neutral", 100: "Like"}	Labels shown on the dial scale
dial_caption	str	no	"Please adjust the slider..."	Caption shown above the dial
tags	s.tag()	no	-	Used for token substitution and reporting

Example Code

from survey import Survey s = Survey(**globals()) s.play_video(video=s.media.ad_clip)

With dial testing:

s.play_video( video=s.media.trailer, dial="bottom", dial_labels={0: "Very Negative", 50: "Neutral", 100: "Very Positive"}, dial_caption="Move the slider to reflect how you're feeling during the video." )

Notes

• All video content is DRM-locked and IP-watermarked if security is set
• Respondents cannot skip; playback is enforced
• Use dial for moment-to-moment reaction measurement
• Best followed by comprehension or diagnostic questions