theBox - Sharing your video content in multiple locations

Where can my videos be shared?

theBox service offers the ability to stream videos in multiple locations:

  • Within UNSW Moodle:
  • On a secured UNSW website (eg. School intranet)
    • Via embed codes (secured or public)
       
  • On an open UNSW website (eg. Faculty homepage)
    • Via embed codes (secured or public only)
       
  • On a non-UNSW website (eg. Smartsparrow, Blogger)
    • Via embed codes (public only)
       
  • Within a program (eg. SCORM Authoring software)
    • Via embed codes (public only*)

* While a secured embed code will not work within a program directly on your computer, some programs can export a file for use within a secured UNSW website. SCORM authoring programs are a good example of this, a secured embed code may not work within the program, but will work once the SCORM package has been uploaded into UNSW Moodle.

theBox service can also share audio, documents and images. However these are not processed by theBox service for web-streaming and there is a higher requirement for the users computer to be setup appropriately. It is typically more common to upload these files to the website directly.

What is an embed code?

A typical webpage is made up of user content formatted with HTML instructions that simply tells the web browser how to display the user content. For example, a simple website may use HTML to control the font and size of a paragraph, or the height and width of an image.

An embed code essentially consists of a web link to a video, with HTML iframe code that tells the web browser how to display the video within the webpage. Many programs can also accept HTML code, though they typically are less functional or more restricted in how they do so than web browsers.

Staff can enable embed codes for their videos, which can be used to display a video within a webpage or program. It is also possible to manually edit the HTML of an embed code to alter the display of the embedded video, eg. changing the size of the video in the page.

theBox service currently supports HTML 4 standard embed codes to maintain compatibility with users on software/devices currently incompatible with HTML 5. This is expected to change in the future as more people use HTML 5 compatible devices/software.

When should I use a secured or public embed code?

theBox service supports two types of embed codes, as controlled by the video owner within theBox:

  1. Secured - These embed codes be used on white-listed UNSW websites only. Secured embed codes cannot be copied and re-used elsewhere, which is important when content is subject to sharing limitations.
  2. Public - These embed codes can be used on any website or program that supports HTML 4 iframes. Public embed codes can be copied by viewers and used elsewhere.

The secured embed link should be used whenever video content should be restricted to staff/student users due to copyright or other limitations, and these links should be embedded within a white-listed UNSW website.

In contrast, public embed links should be used when security is not a concern, but sharing flexibility is.

How to enable public embed codes for use within a public facing website or program

You can embed a video in a website by generating a public embed code within theBox and pasting the resulting embed code into your website's HTML editor. You can also paste the embed code into a particular program if it supports HTML iframes.

To generate a public embed code within theBox:

  1. Log in to theBox using your zID and zPass.
  2. Navigate to the video you want to share.
  3. Click the edit settings button 
  4. Click the Edit Video link. 


Edit video link
 

  1. Scroll down and click on Advanced link.
  2. Scroll down and click Enable next to the Secure Embed Code section.
  3. Click Save.

Secured Embed Code
 

  1. Click on the Embed field.
  2. The embed code will highlight and you can copy it.
  3. Paste the embed code into your website editor, or
  4. Change the optional extra settings that became visible when you clicked on the Embed field as required.

Embed code

  1. Click on the Embed field.
  2. Paste the embed code into your website editor.

How to enable secured embed codes for use within a whitelisted website

You can embed a video in a UNSW whitelisted website (such as UNSW Moodle) by generating a secured embed code within theBox and pasting the resulting embed code into your websites HTML editor.

Note: Some programs can accept the secured embed code, but will not be able to display the video within the program. This is expected behaviour and can be still useful for programs that ultimately create content for a white-listed website, for example a SCORM authoring program may create a SCORM package that is later uploaded into UNSW Moodle.

To generate a secured embed code within theBox:

  1. Log in to theBox using your zID and zPass.
  2. Navigate to the video you want to share.
  3. Click the edit video button or the pencil icon. 
  4. Scroll down to the Restrict access to dropdown and select Just Me


     
  5. Scroll down to the External access title, and click Enable. Click Save.


     
  6. An embed code will now appear on the page.  Click on the embed code.


     
  7. Select the quality you wish to use.
  8. If you want the video to automatically start playing, click the Autostart checkbox. Note, this may not work when used within a program.


     
  9. Click the embed code again and copy it.
  10. Paste the embed code into your website editor and save changes.

Sharing a group of videos on a whitelisted UNSW website

As embedding a group of multiple videos on one webpage can extend the page length and page loading time, it is recommended that a sub-page is created that hosts the videos.

  1. Create a new blank page on your website for the group of videos.
  2. In a separate window, log in to theBox using your zID and zPass.
  3. Navigate to the first video you wish to share.
  4. Click the edit video button or the pencil icon. 
  5. Scroll down to the Restrict access to dropdown and select Public


     
  6. Click Save.
  7. An embed code will now appear on the page.  Click on the embed code.


     
  8. Select the quality you wish to use.
  9. If you want the video to automatically start playing click the Autostart checkbox.


     
  10. Click the embed code again and copy it.
  11. In the first window where you created a new page on your website paste the embed code into your website editor.
  12. Repeat steps 3-11 for each video.

How to increase/decrease the default video size for an embed code

While at first glance a video's embed code (copied from theBox) can look quite complicated, it can be easily edited to change the video's dimensions within a webpage.

Example embed code:

<iframe width="540" height="306" border="0" frameborder="0" allowfullscreen style="border:0 none;" src="https://thebox.unsw.edu.au/video/embed?v=ML2t0OGoEeSr7wL/p5ch3w==&c=DFE6...w=540&h=306"></iframe>

As you can see in the prior example, there are two sets of identical numbers within the embed code.

  • width="540" and height="306"
  • w=540 and h=306

There are two sets of values as the width and height values control the height and width of the iframe in pixels, and the h and w values control the size of the video within the iframe in pixels. These match by default and we recommend that you maintain this for most scenarios.

Adjusting the final video size is just a matter of changing the desired numbers within the embed code, and then using the edited embed code instead.

Example 1 - Standard Size:

<iframe width="540" height="306" border="0" frameborder="0" allowfullscreen style="border:0 none;" src="https://thebox.unsw.edu.au/video/embed?v=ML2t0OGoEeSr7wL/p5ch3w==&c=DFE6...w=540&h=306"></iframe>

Example 2 - Half size:

<iframe width="270" height="153" border="0" frameborder="0" allowfullscreen style="border:0 none;" src="https://thebox.unsw.edu.au/video/embed?v=ML2t0OGoEeSr7wL/p5ch3w==&c=DFE6...w=270&h=153"></iframe>

How can I have a UNSW website white-listed?

To allow the use of secured embed links on a UNSW website, please contact the IT Service Centre on x51333 or itservicecentre@unsw.edu.au with a request to whitelist a website, the website URL and the justification for the white-listing.

Tips for using embed codes in common programs/websites

While the TELT team does not actively investigate the ability of different software packages or services to support embed codes (which are industry standard HTML iframes), we can provide tips on the following.

Microsoft Powerpoint

Microsoft Powerpoint does not support the use of video embed codes from services other then Youtube. For more information please visit this support page.

iSpring Pro

theBox videos can be embedded within SCORM packages created by iSpring, just be aware that secured embed links will only display within the SCORM once it has been uploaded to UNSW Moodle.

Smartsparrow website

theBox videos can be displayed within a Smartsparrow activity by extracting the URL (bolded in the example below) from a public theBox embed code and inserting it into Smartsparrows iframe widget (shown in the image below).

<iframe width="540" height="306" border="0" frameborder="0" allowfullscreen style="border:0 none;" src="https://thebox.unsw.edu.au/video/embed?v=ML2t0OGoEeSr7wL/p5ch3w==&c=DFE66592-48C1-11DE-9396123139020041&a=0&k=A01BB34B962AFB78DACBEADEAE731B68&w=540&h=306"></iframe>

iframe widget.jpg

Note: As a public non-UNSW website, Smartsparrow is not white-listed for secured embed code use at this time.

Adobe Presenter / Captivate

Our understanding is the latest versions of these software packages require HTML 5 iframes, so theBox embed codes currently do not work.