Google+ Platform

Hangouts API 1.2 Release Notes

Note - See the release notes for the latest Hangouts API version.

This release of the Hangouts API introduces several major features and a few minor ones. You can add sound to a participant’s audio stream that everyone in the Hangout can hear. A Hangout On Air now defines a broadcaster and the ability for that broadcaster to control which participants can be viewed on air. In a Hangout On Air, an app now has access to the YouTube ID for the recorded video. New functions allow for disposing of audio and image resources from memory, which lets you avoid having the hangout run out of memory and halt. In addition, several new functions are available as general enhancements.

These features are available in both the developer sandbox and in Hangout apps you make available to the public. These release notes document all new (and deprecated) functions, events and classes.

While shared state is not new to this release, we have published a new Shared State document describing how to use it.

For previous versions of release notes, see previous versions. For release notes for other Google+ APIs, see Google+ Platform Release Notes.

General Enhancements

Local Participant

A new function has been added:

Hangout topic

The topic is the name of the hangout given by the person who starts the hangout. The new function and event are:

  • getTopic - Returns the current hangout topic, or an empty string if a topic was not specified.
  • onTopicChanged - An event that fires when the hangout topic changes. The event object is TopicChangedEvent.

Hangout locale

An app can now get the locale for the hangout. When someone starts a hangout, the hangout's locale is set to that user's locale. The new function and event are:

Renamed functions

Sounds and Image Effects

Playing sounds everyone can hear

You can now add sound to a participant’s audio stream that everyone in the Hangout can hear. For example, you can add a laugh track, music, or sound notifications. The new localOnly parameter lets you determine if the sound plays only locally (true) or for everyone (false). This feature is demonstrated in the Media App. The new functions are:

  • createSound has a new localOnly parameter.
  • play has a new localOnly parameter.
  • Sound.isLocalOnly - Returns true if the sound plays locally only, false if the sound plays locally and is broadcast to other participants.

Tracking the state of resources

The following are new classes and functions that track the state of the app's audio and video resources.

Avoiding running out of memory

Creating an audio or image resource allocates memory in the plugin. Allocating too many resources without disposing them can cause the hangout to run out of memory and halt. These features are implemented as the functions listed below and are demonstrated in the Media App.

Hangouts On Air

A Hangout On Air now has a broadcaster and the ability for that broadcaster to control which participants can be viewed on air. In addition, an app now has access to the YouTube ID for the recorded video. These features are implemented as the functions and events listed below and are demonstrated in the OnAir App.

Broadcaster

A Hangout On Air now has a broadcaster, who is the person who starts the on-air hangout. Only the broadcaster can call the setter functions setNewParticipantInBroadcast and setParticipantInBroadcast (listed in the next sub-section). New parameters are:

  • isBroadcaster - The Participant class has a new isBroadcaster parameter that is true if the participant has broadcaster privileges in this hangout. The broadcaster is the owner of the hangout, but only if it is a Hangout On Air.
  • isInBroadcast - True if the participant will appear in the Hangout On Air broadcast, if this is a Hangout On Air.

Which participants can be viewed

Apps can control which participants in a Hangout On Air appear in the broadcast seen by viewers outside the hangout. These functions are used to power the recently launched Cameraman app. The new functions and event are:

  • setNewParticipantInBroadcast - Sets whether new participants in the hangout are included in the Hangout On Air broadcast by default. This call fails for hangouts that are not On Air, or if the local participant is not the broadcaster of the hangout.
  • isNewParticipantInBroadcast - Returns true if new participants to the hangout are included in the Hangout On Air broadcast by default, false otherwise.

YouTube Live ID

When broadcasting a Hangout On Air, a YouTube video of that hangout is recorded. This ID appears in the video's YouTube URL and uniquely identifies the recording. A corresponding event fires when the ID is set. The new function and event are:

  • getYouTubeLiveId - The YouTube Live ID for the Hangout On Air. The property is null if the ID is not available or the Hangout is not a broadcast Hangout.
  • onYouTubeLiveIdReady - An event that fires when the YouTube Live ID is set for a Hangout On Air. The event object is YouTubeLiveIdReadyEvent.
Release notes for previous versions of Hangouts API

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.