DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Mercurial (1aeaa33a64f9)

VCS Links

Line Code
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

interface nsISpeechService;

[scriptable, builtinclass, uuid(5d7a0b38-77e5-4ee5-897c-ce5db9b85d44)]
interface nsISynthVoiceRegistry : nsISupports
{
  /**
   * Register a speech synthesis voice.
   *
   * @param aService          the service that provides this voice.
   * @param aUri              a unique identifier for this voice.
   * @param aName             human-readable name for this voice.
   * @param aLang             a BCP 47 language tag.
   * @param aLocalService     true if service does not require network.
   * @param aQueuesUtterances true if voice only speaks one utterance at a time
   */
  void addVoice(in nsISpeechService aService, in DOMString aUri,
                in DOMString aName, in DOMString aLang,
                in boolean aLocalService, in boolean aQueuesUtterances);

  /**
   * Remove a speech synthesis voice.
   *
   * @param aService the service that was used to add the voice.
   * @param aUri     a unique identifier of an existing voice.
   */
  void removeVoice(in nsISpeechService aService, in DOMString aUri);

  /**
   * Notify content of voice availability changes. This allows content
   * to be notified of voice catalog changes in real time.
   */
  void notifyVoicesChanged();

  /**
   * Set a voice as default.
   *
   * @param aUri       a unique identifier of an existing voice.
   * @param aIsDefault true if this voice should be toggled as default.
   */
  void setDefaultVoice(in DOMString aUri, in boolean aIsDefault);

  readonly attribute uint32_t voiceCount;

  AString getVoice(in uint32_t aIndex);

  bool isDefaultVoice(in DOMString aUri);

  bool isLocalVoice(in DOMString aUri);

  AString getVoiceLang(in DOMString aUri);

  AString getVoiceName(in DOMString aUri);
};

%{C++
#define NS_SYNTHVOICEREGISTRY_CID                   \
  { /* {7090524d-5574-4492-a77f-d8d558ced59d} */       \
    0x7090524d,                                        \
    0x5574,                                            \
    0x4492,                                            \
    { 0xa7, 0x7f, 0xd8, 0xd5, 0x58, 0xce, 0xd5, 0x9d } \
  }

#define NS_SYNTHVOICEREGISTRY_CONTRACTID \
    "@mozilla.org/synth-voice-registry;1"

#define NS_SYNTHVOICEREGISTRY_CLASSNAME \
    "Speech Synthesis Voice Registry"

%}