Вибрирует устройство в течение заданного количества секунд. Работает на iOS и Android. Обратите внимание, что на iOS значение длины игнорируется и происходит только короткая вибрация, это связано с ограничениями Apple.
void agk::VibrateDevice( float seconds )seconds - Время в секундах для вибрацииИнициализирует механизм преобразования текста в речь на устройстве, чтобы он мог воспроизводить звук. Обратите внимание, что это может быть не сразу, вы должны проверить GetTextToSpeechReady, чтобы увидеть, закончил ли он настройку. Вызов других команд преобразования текста в речь, когда он не готов, будет проигнорирован. В настоящее время работает только на iOS и Android.
void agk::TextToSpeechSetup()Еще не функционирует.
void agk::StopSoundRecording()Останавливает текущий экземпляр, если он еще этого не сделал. При этом экземпляр удаляется, и его идентификатор больше не может быть использован. Идентификатор экземпляра - это значение, возвращаемое из PlaySound при инициировании воспроизведения звука.
void agk::StopSoundInstance( UINT iID )iID - Идентификатор проверяемого экземпляраНемедленно останавливает любой произносимый текст и удаляет все элементы из очереди. В настоящее время работает только на iOS и Android.
void agk::StopSpeaking()Остановите звук, воспроизводимый в данный момент на указанном звуковом номере.
void agk::StopSound( UINT iID )iID - Звук, по-видимому, прекратился.Ставит данный текст в очередь для произнесения. Если какой - то текст уже произносится, то данный текст будет произнесен после окончания текущей речи. Эта команда может быть вызвана несколько раз в быстрой последовательности, чтобы поставить в очередь много текста. Вы можете вызвать IsSpeaking, чтобы проверить, когда очередь пуста и весь текст был произнесен или отменен. Обратите внимание, что при первом вызове этой команды может возникнуть задержка при установке незнакомого языка с помощью SetSpeechLanguage. Например, использование французского языка на устройстве, настроенном для английского языка, попытается загрузить движок французского языка, прежде чем начать говорить текст. Если приложение будет отправлено в фоновый режим, то речь остановится, и весь текст будет удален из очереди. Вы можете указать необязательную задержку в миллисекундах, чтобы устройство подождало, прежде чем начать произносить текст. В настоящее время работает только на iOS и Android.
void agk::Speak( const char *text )
void agk::Speak( const char *text, int delay )text - Текст для выступления
delay - Количество времени в миллисекундах ожидания перед запуском речевого выводаУстанавливает скорость речи, где 1.0-нормальная скорость, 2.0-двойная скорость, 0.5-половинная скорость и так далее. В настоящее время работает только на iOS и Android.
void agk::SetSpeechRate( float rate )rate - Скорость произнесения текста по умолчанию равна 1,0Задает язык, используемый при произнесении текста по голосовому идентификатору. Идентификатор можно найти с помощью GetSpeechVoiceID и необходим, когда несколько голосов имеют один и тот же язык, но с разными акцентами.
void agk::SetSpeechLanguageByID( const char* sID )sID - Язык, используемый для произнесения текста, по умолчанию является текущим языком устройства.Задает язык, используемый при произнесении текста, например en_GB для британского английского, en_US для американского английского, fr_FR для французского и т. Д. Если языковой движок в данный момент не находится на устройстве, то устройство попытается загрузить его при следующем вызове Speak, что может привести к задержке перед произнесением этого текста. Если загрузка завершится неудачно или подключение к Интернету будет недоступно, то будет использоваться языковой движок по умолчанию для текущего устройства. В настоящее время работает только на iOS и Android.
void agk::SetSpeechLanguage( const char* lang )lang - Язык, используемый для произнесения текста, по умолчанию является текущим языком устройства.Устанавливает основную громкость звука для всех звуков. Отдельные объемы звука останутся нетронутыми, но все объемы умножаются на основную громкость звука, позволяя использовать такие функции, как затухание.
void agk::SetSoundSystemVolume( int iVol )iVol - Основная громкость звука для всех звуков.Устанавливает текущий объем указанного экземпляра в диапазоне от 0 до 100. Идентификатор экземпляра - это значение, возвращаемое из PlaySound при инициировании воспроизведения звука.
void agk::SetSoundInstanceVolume( UINT iID, int vol )iID - Идентификатор экземпляра для изменения
vol - Новый том экземпляра, от 0 до 100Устанавливает текущую скорость воспроизведения указанного экземпляра, где 1.0-нормальная скорость, 2.0 - двойная скорость и так далее. Не все устройства гарантированно поддерживают изменение скорости воспроизведения. Используйте GetSoundMaxRate и GetSoundMinRate для проверки допустимых диапазонов для текущего устройства, любые значения вне этого диапазона будут зажаты. Идентификатор экземпляра - это значение, возвращаемое из PlaySound при инициировании воспроизведения звука.
void agk::SetSoundInstanceRate( UINT iID, float rate )iID - Идентификатор экземпляра для изменения
rate - Новая скорость воспроизведения экземпляраУстанавливает текущий баланс указанного экземпляра, при этом 0 находится по центру, -1.0-все на левом динамике, а 1.0-все на правом динамике, любые значения вне этого диапазона будут зажаты. Это лучше всего работает с моно-звуками, но может быть применено и к стереозвукам. Идентификатор экземпляра - это значение, возвращаемое из PlaySound при инициировании воспроизведения звука.
void agk::SetSoundInstanceBalance( UINT iID, float balance )iID - Идентификатор экземпляра для изменения
balance - Новый баланс экземпляраУстанавливает, будет ли приложение разрешать фоновую музыку из других приложений продолжать воспроизведение (режим=0) или отключать другие приложения, пока это приложение активно (режим=1). Обратите внимание, что в режиме 0 устройство считает звук вашего приложения несущественным, поэтому будет отключено, если звонок устройства установлен в бесшумное состояние. Это работает только на iOS.
void agk::SetSoundDeviceMode( int mode )mode - Используемый звуковой режим (по умолчанию=0)Сохраняет звуковой файл в папку записи приложения.
void agk::SaveSound( UINT iID, const char* sFilename )iID - Идентификатор звука для сохранения.
sFilename - Имя файла, которое будет использоваться для звукового файла, рекомендуется заканчивать на .wav.Еще не функционирует.
void agk::RecordSound( const char* szFilename )szFilename - Файл для сохранения звука.Воспроизведение звука, ранее загруженного в указанный звуковой номер. Эта команда может быть вызвана несколько раз для одного и того же идентификатора звука, и она запустит несколько копий этого звука, воспроизводимых в качестве экземпляров. Команда вернет идентификатор экземпляра, который можно использовать для взаимодействия с этим экземпляром во время его воспроизведения. Когда экземпляр перестает воспроизводиться, он автоматически удаляется и больше не может быть использован. По умолчанию звук не зацикливается.
UINT agk::PlaySound( UINT iID, int iVol )
UINT agk::PlaySound( UINT iID, int iVol, int iLoop )
UINT agk::PlaySound( UINT iID, int iVol, int iLoop, int iPriority )
UINT agk::PlaySound( UINT iID )iID - Звуковой номер для воспроизведения.
iVol - Громкость, на которой должен воспроизводиться звук (необязательно, по умолчанию 100).
iLoop - Количество раз, чтобы зациклить экземпляр, или 1 навсегда.
iPriority - Зарезервировано для будущего использования, должно быть 0 (необязательно, по умолчанию 0).Загружает звуковой файл из папки мультимедиа приложения и возвращает номер звука. Пути к файлам должны быть относительными, а не абсолютными, вы не можете загружать звуковые файлы из другого места на диске. Обратите внимание, что сжатые WAV-файлы не поддерживаются. Вы должны использовать несжатые WAV-файлы, чтобы обеспечить совместимость на всех платформах.
UINT agk::LoadSound( const char* sFilename )
void agk::LoadSound( UINT iID, const char* sFilename )sFilename - Имя файла загружаемого звукового файла должно быть WAV-файлом.
iID - Звуковой номер для хранения звука.Загружает звуковой файл из папки мультимедиа приложения. Пути к файлам должны быть относительными, а не абсолютными, вы не можете загружать звуковые файлы из других мест на диске. Эта команда берет сжатый OGG-файл и распаковывает его во время загрузки, позволяя вам сохранить размер файла, но использование памяти будет таким же, как если бы вы использовали WAV-файл. Если вы хотите использовать OGG, а также экономить память, то используйте новые команды LoadMusicOGG.
void agk::LoadSoundOGG( UINT iID, const char* sFilename )
UINT agk::LoadSoundOGG( const char* sFilename )iID - Звуковой номер для хранения звука.
sFilename - Имя файла загружаемого звукового файла должно быть OGG-файлом.
Filename - Имя файла загружаемого звукового файла должно быть OGG-файлом.Возвращает 1, если Speak был вызван, а текст еще не закончен. Если несколько элементов текста были поставлены в очередь, то эта команда будет продолжать возвращать 1 до тех пор, пока все они не будут произнесены или не будет вызван StopSpeaking. В настоящее время работает только на iOS и Android.
int agk::IsSpeaking()Еще не функционирует.
int agk::IsSoundRecording()Возвращает 1, когда механизм преобразования текста в речь готов начать преобразование текста в речь. Вызов других команд преобразования текста в речь, когда он не готов, будет проигнорирован. В настоящее время работает только на iOS и Android.
int agk::GetTextToSpeechReady()Возвращает имя заданного голоса. На iOS это имя читается человеком, но не дает никаких подробностей о акценте или языке этого голоса. На Android имя дает информацию о языке и акценте, но не так легко читается. В настоящее время работает только на iOS и Android.
char* agk::GetSpeechVoiceName( int index )index - Индекс голоса, который нужно проверить, начинается с 0 для первого голосаВозвращает идентификатор данного голоса. Идентификатор можно использовать с SetSpeechLanguageByID для выбора конкретного голоса.
char* agk::GetSpeechVoiceID( int index )index - Индекс голоса, который нужно проверить, начинается с 0 для первого голосаВозвращает количество голосов, которые можно выбрать с помощью команды SetSpeechLanguage. Вы можете использовать команды GetSpeechVoiceName и GetSpeechVoiceLanguage, чтобы получить подробную информацию о различных голосах. В настоящее время работает только на iOS и Android.
int agk::GetSpeechNumVoices()Возвращает языковую строку данного голоса. Это можно использовать непосредственно с командой SetSpeechLanguage, чтобы использовать этот голос для любой будущей речи. В настоящее время работает только на iOS и Android.
char* agk::GetSpeechVoiceLanguage( int index )index - Индекс голоса, который нужно проверить, начинается с 0 для первого голосаВозвращает количество экземпляров этого звукового идентификатора, которые в данный момент воспроизводятся или зацикливаются. Это точно так же, как GetSoundInstances.
UINT agk::GetSoundsPlaying( UINT iID )iID - Звуковой номер для проверки.Получает минимальную скорость и какие звуковые файлы могут быть воспроизведены на этом устройстве. Скорость 1,0 - это нормальная скорость, скорость 2,0-это двойная скорость, 0,5-половина скорости и так далее. Если вы попытаетесь изменить скорость воспроизведения звука за пределами этих значений, она будет привязана к этим значениям. Если и min, и max возвращают 1.0, то изменение скорости воспроизведения звука на этом устройстве не поддерживается.
float agk::GetSoundMinRate()Получает максимальную скорость и какие звуковые файлы могут быть воспроизведены на этом устройстве. Скорость 1,0 - это нормальная скорость, скорость 2,0-это двойная скорость, 0,5-половина скорости и так далее. Если вы попытаетесь изменить скорость воспроизведения звука за пределами этих значений, она будет привязана к этим значениям. Если и min, и max возвращают 1.0, то изменение скорости воспроизведения звука на этом устройстве не поддерживается.
float agk::GetSoundMaxRate()Возвращает количество экземпляров этого звукового идентификатора, которые в данный момент воспроизводятся или зацикливаются. Это точно так же, как GetSoundsPlaying.
UINT agk::GetSoundInstances( UINT iID )iID - Звуковой номер для проверки.Возвращает текущую скорость воспроизведения указанного экземпляра, где 1.0-нормальная скорость, 2.0 - двойная скорость и т. Д. Не все устройства гарантированно поддерживают изменение скорости воспроизведения.
float agk::GetSoundInstanceRate( UINT iID )iID - Идентификатор проверяемого экземпляраВозвращает текущий объем указанного экземпляра в диапазоне от 0 до 100.
int agk::GetSoundInstanceVolume( UINT iID )iID - Идентификатор проверяемого экземпляраВозвращает 1, если данный экземпляр все еще воспроизводится или зацикливается, и 0, если он остановился. Идентификатор экземпляра - это значение, возвращаемое из PlaySound при инициировании воспроизведения звука. Как только эта команда вернет 0, экземпляр будет удален и на него больше нельзя будет ссылаться, любая попытка изменить его будет проигнорирована. Вам нужно будет создать новый экземпляр, снова используя PlaySound.
int agk::GetSoundInstancePlaying( UINT iID )iID - Идентификатор проверяемого экземпляраЕсли звук воспроизводился с включенным циклированием, эта команда возвращает количество завершенных до сих пор циклов. Если экземпляр использует фиксированное количество циклов, то он никогда на самом деле не достигнет этого значения количества циклов, так как будет немедленно удален по достижении конца своего последнего цикла. Идентификатор экземпляра - это значение, возвращаемое из PlaySound при инициировании воспроизведения звука.
int agk::GetSoundInstanceLoopCount( UINT iID )iID - Идентификатор проверяемого экземпляраВозвращает значение 1, если указанный звуковой номер существует, в противном случае возвращается 0.
UINT agk::GetSoundExists( UINT iID )iID - Звуковой номер для проверки.Удалите звук по указанному номеру звука. Это также приведет к удалению всех экземпляров звука.
void agk::DeleteSound( UINT iID )iID - Звуковой номер для удаления.