Game Frame is a presentation component for the Adapt framework.

Game Frame is based on the Responsive Iframe plugin and is built to allow you to embed responsive HTML5 games from tools like PhaserJS into your course and block the course from continuing until the game is complete.

Visit the Game Frame wiki for more information about its functionality and for explanations of key properties.

##Installation

With the Adapt CLI installed, run the following from the command line:
adapt install adapt-game-frame

Alternatively, this component can also be installed by adding the following line of code to the *adapt.json* file:  
`"adapt-game-frame": "*"`  
Then running the command:  
`adapt install`  
(This second method will reinstall all plug-ins listed in *adapt.json*.)  

The attributes listed below are used in components.json to configure Game Frame, and are properly formatted as JSON in example.json.

core model attributes: These are inherited by every Adapt component. Read more.

_component (string): This value must be: game-frame.

_classes (string): CSS class name to be applied to Game Frame’s containing div. The class must be predefined in one of the Less files. Separate multiple classes with a space.

_layout (string): This defines the horizontal position of the component in the block. Acceptable values are full.

instruction (string): This optional text appears above the component. It is frequently used to guide the learner’s interaction with the component.

_source (string): The source of the game's index.html (e.g. course/en/game/index.html)

_loadingImg (string): The source of an image that can show to prevent an empty black square when the user hasn't clicked on the game.

_originURL (string): This is the URL of the adapt course. This allows the game to pass a message to the course using the postMessage API, e.g. http://localhost:9001 This message is used to trigger the setCompletionStatus for the component and block.

This plugin uses the postMessage API to pass a message back to the Adapt course. Within the components.json, you must change the _originURL to match the origin URL of the Adapt course.

Inside of your game, you must include a postMessage call with the same origin URL, for example:

window.top.postMessage("The game is complete", "http://knanthony.com");

where the first argument is the message to pass and the second argument is the target origin. The target origin must match the origin URL of the Adapt course.

Phaser JS scale manager is not working appropriately on iOS devices. So, this plugin includes an object tag which performs responsively on iOS devices. To use the object tag instead of the iframe, you must comment out the iframe tag in the game-frame.hbs (handlebars template) and uncomment the object tag version.

<div class="component-inner gameIframe-inner">
  {{> component this}}
  <div class="component-widget gameIframe-widget">
    <div class="gameIframe-iframe-holder">
      <img src="{{_loadingImg}}" />
      <!-- <iframe scrolling="{{#if _scrolling}}{{_scrolling}}{{else}}no{{/if}}" class="gameIframe-iframe" src="">
      </iframe> -->
      <object type="text/html" data="" class="gameIframe-object"></object>
    </div>
  </div>
</div>

You must also comment out the iframe-specific command in the once method and uncomment the object-specific command:

once: function(fired) {
          if (!fired) {
            this.$('.gameIframe-object').attr('data', this.model.get('_source'));
            // this.$('.gameIframe-iframe').attr('src', this.model.get('_source'));
          } else {
            return;
          }
        },

The message is still passed appropriately to the Adapt course.

Version number: 1.1.0 Framework versions: 2.0
Author / maintainer: Kristin Anthony
Accessibility support: Unknown
RTL support: no
Cross-platform coverage: Latest Chrome, Firefox, Safari, iOS Chrome