Source: externs/shaka/text.js

  1. /*! @license
  2.  * Shaka Player
  3.  * Copyright 2016 Google LLC
  4.  * SPDX-License-Identifier: Apache-2.0
  5.  */
  8. /**
  9.  * @externs
  10.  */
  13. /**
  14.  * An interface for plugins that parse text tracks.
  15.  *
  16.  * @interface
  17.  * @exportDoc
  18.  */
  19. shaka.extern.TextParser = class {
  20.   /**
  21.    * Parse an initialization segment. Some formats do not have init
  22.    * segments so this won't always be called.
  23.    *
  24.    * @param {!Uint8Array} data
  25.    *    The data that makes up the init segment.
  26.    *
  27.    * @exportDoc
  28.    */
  29.   parseInit(data) {}
  31.   /**
  32.    * Parse a media segment and return the cues that make up the segment.
  33.    *
  34.    * @param {!Uint8Array} data
  35.    *    The next section of buffer.
  36.    * @param {shaka.extern.TextParser.TimeContext} timeContext
  37.    *    The time information that should be used to adjust the times values
  38.    *    for each cue.
  39.    * @param {?(string|undefined)} uri
  40.    *    The media uri.
  41.    * @return {!Array.<!shaka.text.Cue>}
  42.    *
  43.    * @exportDoc
  44.    */
  45.   parseMedia(data, timeContext, uri) {}
  47.   /**
  48.    * Notifies the stream if the manifest is in sequence mode or not.
  49.    *
  50.    * @param {boolean} sequenceMode
  51.    */
  52.   setSequenceMode(sequenceMode) {}
  54.   /**
  55.    * Notifies the manifest type.
  56.    *
  57.    * @param {string} manifestType
  58.    */
  59.   setManifestType(manifestType) {}
  60. };
  63. /**
  64.  * A collection of time offsets used to adjust text cue times.
  65.  *
  66.  * @typedef {{
  67.  *   periodStart: number,
  68.  *   segmentStart: number,
  69.  *   segmentEnd: number,
  70.  *   vttOffset: number
  71.  * }}
  72.  *
  73.  * @property {number} periodStart
  74.  *     The absolute start time of the period in seconds.
  75.  * @property {number} segmentStart
  76.  *     The absolute start time of the segment in seconds.
  77.  * @property {number} segmentEnd
  78.  *     The absolute end time of the segment in seconds.
  79.  * @property {number} vttOffset
  80.  *     The start time relative to either segment or period start depending
  81.  *     on <code>segmentRelativeVttTiming</code> configuration.
  82.  *
  83.  * @exportDoc
  84.  */
  85. shaka.extern.TextParser.TimeContext;
  88. /**
  89.  * @typedef {function():!shaka.extern.TextParser}
  90.  * @exportDoc
  91.  */
  92. shaka.extern.TextParserPlugin;
  95. /**
  96.  * @summary
  97.  * An interface for plugins that display text.
  98.  *
  99.  * @description
  100.  * This should handle displaying the text cues on the page.  This is given the
  101.  * cues to display and told when to start and stop displaying.  This should only
  102.  * display the cues it is given and remove cues when told to.
  103.  *
  104.  * <p>
  105.  * This should only change whether it is displaying the cues through the
  106.  * <code>setTextVisibility</code> function; the app should not change the text
  107.  * visibility outside the top-level Player methods.  If you really want to
  108.  * control text visibility outside the Player methods, you must set the
  109.  * <code>streaming.alwaysStreamText</code> Player configuration value to
  110.  * <code>true</code>.
  111.  *
  112.  * @interface
  113.  * @extends {shaka.util.IDestroyable}
  114.  * @exportDoc
  115.  */
  116. shaka.extern.TextDisplayer = class {
  117.   /**
  118.    * @override
  119.    * @exportDoc
  120.    */
  121.   destroy() {}
  123.   /**
  124.    * Append given text cues to the list of cues to be displayed.
  125.    *
  126.    * @param {!Array.<!shaka.text.Cue>} cues
  127.    *    Text cues to be appended.
  128.    *
  129.    * @exportDoc
  130.    */
  131.   append(cues) {}
  133.   /**
  134.    * Remove all cues that are fully contained by the given time range (relative
  135.    * to the presentation). <code>endTime</code> will be greater to equal to
  136.    * <code>startTime</code>.  <code>remove</code> should only return
  137.    * <code>false</code> if the displayer has been destroyed. If the displayer
  138.    * has not been destroyed <code>remove</code> should return <code>true</code>.
  139.    *
  140.    * @param {number} startTime
  141.    * @param {number} endTime
  142.    *
  143.    * @return {boolean}
  144.    *
  145.    * @exportDoc
  146.    */
  147.   remove(startTime, endTime) {}
  149.   /**
  150.    * Returns true if text is currently visible.
  151.    *
  152.    * @return {boolean}
  153.    *
  154.    * @exportDoc
  155.    */
  156.   isTextVisible() {}
  158.   /**
  159.    * Set text visibility.
  160.    *
  161.    * @param {boolean} on
  162.    *
  163.    * @exportDoc
  164.    */
  165.   setTextVisibility(on) {}
  166. };
  169. /**
  170.  * A factory for creating a TextDisplayer.
  171.  *
  172.  * @typedef {function():!shaka.extern.TextDisplayer}
  173.  * @exportDoc
  174.  */
  175. shaka.extern.TextDisplayer.Factory;