 |
|---|
| Loading |
This field plug-in can detect how long a YouTube video has been playing for.
- Display a YouTube video.
- Track how long the YouTube video is played for.
- Track if video completed or not.
- Auto-fit video based on field area and screen size.
- Display "Loading..." at the top until the video loads.
- Optional: Reset the time tracking if the enumerator returns to the field and plays the video again.
- Optional: Autoplay YouTube video.
Android: Android 7 or up
iOS and web browsers: Because web browsers and iOS devices are kept more up-to-date with the latest features, nearly all web browsers and iOS devices should support the field plug-in, but test it on your collection device beforehand to be sure.
Because the video is coming from YouTube, this field plug-in requires an internet connection.
The field value will be the selected choice.
The metadata will store two pieces of data in a space-separated list:
- The time in seconds the video was playing for.
- A
1if the video played until the end, and0otherwise.
For example, if the video was played for 5.5 seconds, and did not play until the end, then the metadata will be:
5.5 0
You can use the plug-in-metadata() function to retrieve the metadata (it is a good idea to use it in a calculate_here field so it updates when needed), and the selected-at() function to retrieve each individual piece of data. Check out our documentation on using expressions to learn more.
This field plug-in tracks how much time the video was playing, not how much of the video was watched. Hypothetically (though unlikely), a respondent could watch the same five seconds of video four times, and the field plug-in would track that as watching the video for 20 seconds. This is why checking if the video completed or not can be helpful.
To use this plug-in as is:
- Download the sample form. You can use the sample form as-is, or adjust the parameters to change the behavior (see below).
- Download the youtube-detector.fieldplugin.zip file from this repo.
- Upload the sample form to your server, with the field plug-in attached.
| Name | Description |
|---|---|
video (required) |
The ID of the YouTube video. When you go to a YouTube video in a web browser, if you look at the URL, you'll notice it starts If you accidentially use the full URL instead, the field plug-in is smart enough to extract the video ID, so don't worry if you use the full URL instead. |
autoplay (optional) |
If this parameter has a value of 1, then the video will play as soon as it loads. Otherwise, the video will not play until the enumerator clicks on it. |
reset (optional) |
If this parameter is not defined, then if the respondent watches the video for 5 seconds, moves away from the field, returns to the video, and continues watching the video for 10 seconds, then their time spent watching the video will be tracked as 15 seconds, If this parameter has a value of Because this will make the respondent lose their watch progress if they start the video over, if you do use this parameter, it is a good idea to have a warning to the respondent If the respondent leaves the field, returns, but does not play the video again, then their time will not reset. |
min_seconds (optional) |
Minimum number of seconds the video must be watched for before the enumerator can move on to the next field. |
This field plug-in allows you to customize where the video will go in the field label. Take a look at this:
<div id="player"></div>
Simply add that to the location in the field label where you would like the video displayed, and the video will load there. Check out the sample form for an example.
| Feature / Property | Support |
|---|---|
| Supported field type(s) | select_one, select_multiple |
| Default values | Yes |
| Custom constraint message | Yes |
| Custom required message | Yes |
| Read only | Yes |
| media:image | Yes |
| media:audio | Yes |
| media:video | Yes |
quick appearance |
Yes (select_one only) |
minimal appearance |
Yes (select_one only) |
compact appearance |
No |
compact-# appearance |
No |
quickcompact appearance |
No |
quickcompact-# appearance |
No |
likert appearance |
Yes (select_one only) |
likert-min appearance |
Yes* (select_one only) |
likert-mid appearance |
No |
label appearance |
Yes |
list-nolabel appearance |
Yes |
*Note: this plug-in works well for the likert-min appearance when the field label is short, and does not contain an image, audio, or video. This is currently a known limitation.
This field plug-in uses the YouTube IFrame player API from Google.
-
Developer documentation
Instructions and resources for developing your own field plug-ins.
https://github.com/surveycto/Field-plug-in-resources -
User documentation
How to get started using field plug-ins in your SurveyCTO form.
https://docs.surveycto.com/02-designing-forms/03-advanced-topics/06.using-field-plug-ins.html