mirror of
https://gitcode.com/GitHub_Trending/ji/jitsi-meet.git
synced 2026-05-14 11:37:48 +00:00
8b2ce21e1a
On Android the files will be copied to the assets/sounds directory of the SDK bundle on build time. To play the "asset:/" prefix has to be used to locate the files correctly. On iOS each sound file must be added to the SDK's Xcode project in order to be bundled correctly. To playback we need to know the path of the SDK bundle which is now exposed by the AppInfo iOS module.
119 lines
3.4 KiB
JavaScript
119 lines
3.4 KiB
JavaScript
// @flow
|
|
|
|
import type { AudioElement } from '../media';
|
|
|
|
import {
|
|
_ADD_AUDIO_ELEMENT,
|
|
_REMOVE_AUDIO_ELEMENT,
|
|
PLAY_SOUND,
|
|
REGISTER_SOUND,
|
|
UNREGISTER_SOUND
|
|
} from './actionTypes';
|
|
import { getSoundsPath } from './functions';
|
|
|
|
/**
|
|
* Adds {@link AudioElement} instance to the base/sounds feature state for the
|
|
* {@link Sound} instance identified by the given id. After this action the
|
|
* sound can be played by dispatching the {@link PLAY_SOUND} action.
|
|
*
|
|
* @param {string} soundId - The sound identifier for which the audio element
|
|
* will be stored.
|
|
* @param {AudioElement} audioElement - The audio element which implements the
|
|
* audio playback functionality and which is backed by the sound resource
|
|
* corresponding to the {@link Sound} with the given id.
|
|
* @protected
|
|
* @returns {{
|
|
* type: PLAY_SOUND,
|
|
* audioElement: AudioElement,
|
|
* soundId: string
|
|
* }}
|
|
*/
|
|
export function _addAudioElement(soundId: string, audioElement: AudioElement) {
|
|
return {
|
|
type: _ADD_AUDIO_ELEMENT,
|
|
audioElement,
|
|
soundId
|
|
};
|
|
}
|
|
|
|
/**
|
|
* The opposite of {@link _addAudioElement} which removes {@link AudioElement}
|
|
* for given sound from base/sounds state. It means that the audio resource has
|
|
* been disposed and the sound can no longer be played.
|
|
*
|
|
* @param {string} soundId - The {@link Sound} instance identifier for which the
|
|
* audio element is being removed.
|
|
* @protected
|
|
* @returns {{
|
|
* type: _REMOVE_AUDIO_ELEMENT,
|
|
* soundId: string
|
|
* }}
|
|
*/
|
|
export function _removeAudioElement(soundId: string) {
|
|
return {
|
|
type: _REMOVE_AUDIO_ELEMENT,
|
|
soundId
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Starts playback of the sound identified by the given sound id. The action
|
|
* will have effect only if the audio resource has been loaded already.
|
|
*
|
|
* @param {string} soundId - The id of the sound to be played (the same one
|
|
* which was used in {@link registerSound} to register the sound).
|
|
* @returns {{
|
|
* type: PLAY_SOUND,
|
|
* soundId: string
|
|
* }}
|
|
*/
|
|
export function playSound(soundId: string): Object {
|
|
return {
|
|
type: PLAY_SOUND,
|
|
soundId
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Registers a new sound for given id and a source object which can be either a
|
|
* path or a raw object depending on the platform (native vs web). It will make
|
|
* the {@link SoundCollection} render extra HTMLAudioElement which will make it
|
|
* available for playback through the {@link playSound} action.
|
|
*
|
|
* @param {string} soundId - The global identifier which identify the sound
|
|
* created for given source object.
|
|
* @param {string} soundName - The name of bundled audio file that will be
|
|
* associated with the given {@code soundId}.
|
|
* @returns {{
|
|
* type: REGISTER_SOUND,
|
|
* soundId: string,
|
|
* src: string
|
|
* }}
|
|
*/
|
|
export function registerSound(soundId: string, soundName: string): Object {
|
|
return {
|
|
type: REGISTER_SOUND,
|
|
soundId,
|
|
src: `${getSoundsPath()}/${soundName}`
|
|
};
|
|
}
|
|
|
|
/**
|
|
* Unregister the sound identified by the given id. It will make the
|
|
* {@link SoundCollection} component stop rendering the corresponding
|
|
* {@code HTMLAudioElement} which then should result in the audio resource
|
|
* disposal.
|
|
*
|
|
* @param {string} soundId - The identifier of the {@link Sound} to be removed.
|
|
* @returns {{
|
|
* type: UNREGISTER_SOUND,
|
|
* soundId: string
|
|
* }}
|
|
*/
|
|
export function unregisterSound(soundId: string): Object {
|
|
return {
|
|
type: UNREGISTER_SOUND,
|
|
soundId
|
|
};
|
|
}
|