javax.tv.service.selection.AlternativeContentEvent Maven / Gradle / Ivy

Go to download
/*
 * @(#)AlternativeContentEvent.java	1.13 00/08/26
 *
 * Copyright 1998-2000 by Sun Microsystems, Inc.,
 * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
 * All rights reserved.
 * 
 * This software is the confidential and proprietary information
 * of Sun Microsystems, Inc. ("Confidential Information").  You
 * shall not disclose such Confidential Information and shall use
 * it only in accordance with the terms of the license agreement
 * you entered into with Sun.
 */

package javax.tv.service.selection;

/**
 * AlternativeContentEvent is generated to indicate that
 * "alternative" content is being presented during the presentation of
 * a service. Alternative content is content not actually part of the
 * requested service, such as content related to conditional access
 * failures (e.g., purchase dialogs or advertising for content for
 * which the user is not yet authorized). The presentation of
 * alternative content is always initiated by the system and never by
 * applications.
 *
 * This event will be generated in two situations:
 *
 * 
  At the end of a successful service selection operation,
 * this event will be generated if any of the service components being
 * presented are alternative content. Under these conditions, the
 * generation of this event signals a change in state of the service
 * context from the presentation pending state to the
 * presenting state.  A NormalContentEvent will
 * not be generated.  
 *
 * 
 * During the presentation of a service, this event will be generated
 * if any of the service components being presented are replaced by
 * alternative content.  One example of this is the expiration of a free
 * preview period. In this case, generation of this event does not
 * impact the service context state model.
 * 
 * 
 *
 * Presentation failures enforced via a conditional access system may
 * be reported by this event or by a SelectionFailedEvent
 * with the CA_REFUSAL reason code. Which of these is
 * used depends on the precise nature of the conditional access
 * system. Applications must allow for both modes of failure.
 * 
 * @see NormalContentEvent
 * @see SelectionFailedEvent */

public class AlternativeContentEvent extends PresentationChangedEvent
{

  /**
   * Constructs the event.
   *
   * @param source The ServiceContext that generated the
   * event.
   */
  public AlternativeContentEvent(ServiceContext source)
  {
    super(null);
  }
}