@twilio/rtc-diagnostics/es5/lib/constants.js

Various diagnostics functions to help analyze connections to Twilio

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
var pack = require("../package.json");
/**
 * @private
 * Parameters passed to our audio encoder
 * buffer size, input channels, output channes
 */
exports.ENCODER_PARAMS = [2048, 1, 1];
/**
 * @private
 * Max number of packets to send to data channel for bitrate test
 */
exports.MAX_NUMBER_PACKETS = 100;
/**
 * @private
 * Minimum bitrate required to pass bitrate test
 * See https://www.twilio.com/docs/voice/client/javascript/voice-client-js-and-mobile-sdks-network-connectivity-requirements#network-bandwidth-requirements
 */
exports.MIN_BITRATE_THRESHOLD = 100;
/**
 * @private
 * Minimum bitrate samples required to emit warnings.
 * See [[WarningName.LowBitrate]]
 */
exports.MIN_BITRATE_SAMPLE_COUNT = 5;
/**
 * @private
 * Minimum number of failing bitrate values before emitting a warning.
 * See [[WarningName.LowBitrate]]
 */
exports.MIN_BITRATE_FAIL_COUNT = 3;
/**
 * @private
 * Data channel buffered amount
 */
exports.BYTES_KEEP_BUFFERED = 1024 * exports.MAX_NUMBER_PACKETS;
/**
 * @private
 * Test packet used for bitrate test
 */
exports.TEST_PACKET = Array(1024).fill('h').join('');
/**
 * @private
 * We are unable to use the `.ogg` file here in Safari.
 */
exports.INCOMING_SOUND_URL = "https://sdk.twilio.com/js/client/sounds/releases/1.0.0/incoming.mp3?cache=" + pack.name + "+" + pack.version;
/**
 * @private
 * The number of milliseconds to wait to receive data in bitrate test before timing out.
 */
exports.BITRATE_TEST_TIMEOUT_MS = 15000;
/**
 * All of the expected error names to be thrown by the diagnostics tests.
 * These names are set in the error objects as the `.name` member.
 */
var ErrorName;
(function (ErrorName) {
    ErrorName["AlreadyStoppedError"] = "already-stopped";
    ErrorName["DiagnosticError"] = "diagnostic";
    ErrorName["InvalidOptionsError"] = "invalid-options";
    ErrorName["InvalidStateError"] = "invalid-state";
    ErrorName["UnsupportedError"] = "unsupported";
})(ErrorName = exports.ErrorName || (exports.ErrorName = {}));
/**
 * All of the expected warnings raised by the diagnostics tests.
 * A `warning-cleared` event is raised if there is an active warning
 * and if the criteria of the warning are no longer met.
 *
 * Example:
 *
 * ```ts
 * test.on(AudioInputTest.Events.Warning, (warningName: WarningName) => {
 *  console.log(`Warning detected: ${warningName}`);
 * });
 *
 * test.on(AudioInputTest.Events.WarningCleared, (warningName: WarningName) => {
 *  console.log(`Warning cleared: ${warningName}`);
 * });
 * ```
 *
 */
var WarningName;
(function (WarningName) {
    /**
     * Raised by the [[AudioInputTest]] when the volume events recorded are both low and constant.
     * The criteria for raising this warning are:
     * - If there are at least three seconds worth of audio samples.
     * - The standard deviation of those samples is less than 1% of the max
     *   possible volume value (255).
     * - The average of those samples is less than 1% of the max possible volume
     *   value (255).
     */
    WarningName["LowAudioLevel"] = "low-audio-level";
    /**
     * Raised by the [[MediaConnectionBitrateTest]] when the recorded bitrates are consistently lower than a certain threshold.
     * The criteria for raising this warning are:
     *  - At least 5 seconds worth of bitrate values have been recorded.
     *  - 3 out of last 5 bitrate values are less than [[MediaConnectionBitrateTest.Options.minBitrateThreshold]].
     */
    WarningName["LowBitrate"] = "low-bitrate";
})(WarningName = exports.WarningName || (exports.WarningName = {}));
//# sourceMappingURL=constants.js.map