Audio

Read-only na audio value para makilala ang mga tunog sa app o laro. Gamitin ang Audio(name) para mag-load ng naka-save na sample, o Audio.recent(duration_ms) para kopyahin ang kakakuha pa lang na audio. Sa device ginagawa ang capture at pagtutugma; hindi ina-upload ang tuloy-tuloy na listening buffer at hindi naa-access ng script ang raw audio (PCM).

Syntax

Audio(name)

Mga parameter ng constructor

PangalanPaglalarawan
nameString
Kailangang ilagay ang pangalan ng sample na ginawa sa Template Manager ng kasalukuyang macro; hindi ito maaaring walang laman o isang file path. Agad nilo-load ang sample, kasama ang mga naibalik o nasa package na protektado ng encryption; error ang nawawala o sirang sample. Sine-save ng Backup/Store ang napiling source at mga sample kasama ng macro: hanggang 32 WAV sample na PCM16 mono 48 kHz, hanggang 10 segundo bawat isa, at hanggang 4 MiB ang kabuuang WAV data.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Halimbawa

# Kilalanin ang lokal na audio sample pagkatapos magsimulang makinig
sample = Audio("alert")
Audio.start()
wait(2000)
clip = Audio.recent(duration_ms=2000)
result = clip.match(sample, threshold=0.85)
if result.matched:
    print(result.score, result.start_ms, result.end_ms)
Audio.stop()

Mga field

PangalanPaglalarawan
nameString | None
Pangalan ng naka-save na sample, o None para sa pinakabagong snapshot.
duration_msNumber
Haba ng snapshot sa millisecond.
start_msNumber
Oras ng simula sa millisecond; zero para sa sample na may pangalan, at mula sa simula ng session para sa pinakabagong snapshot.
end_msNumber
Oras ng pagtatapos na hindi kasama sa saklaw, sa millisecond sa parehong timeline ng start_ms.
Halimbawa ng constructor
# I-load ang sample na naka-save sa makrong ito
audio = Audio("alert")

Mga method

5 method

Audio.start

Simulang makinig sa audio ng napiling app, hindi sa mikropono. Kailangan ng Android 10+, pahintulot sa pag-record, pagsang-ayon sa MediaProjection, at source app na nagpapahintulot sa capture. Nananatili ang buffer kapag tinawag muli habang nakikinig. Nagre-reset ang oras ng sesyon kapag nagsimulang muli matapos ang stop; i-reset din ang naka-save na oras ng detection. Nililinis ng Pause ang history, pero mula pa rin sa orihinal na simula ng sesyon ang oras sa Resume at kasama ang tagal ng pag-pause. Error kapag kulang ang pahintulot, configuration, o capture session.

Syntax

Audio.start()

Ibinabalik na halaga

None

Halimbawa

# Simulan ang pagkuha ng audio ng naka-configure na app pagkatapos ng pahintulot at pagsang-ayon
Audio.start()

Audio.stop

Ihinto ang audio capture at linisin ang buffer nito. Magagamit pa rin ang mga audio value na naibalik na; patuloy ang screen capture na ginagamit sa ibang bahagi. Nire-release din ang audio capture kapag natapos ang macro.

Syntax

Audio.stop()

Ibinabalik na halaga

None

Halimbawa

# Bitawan ang naka-configure na audio recorder
Audio.stop()

Audio.recent

Kopyahin ang pinakabagong audio sa isang hiwalay na snapshot nang hindi naghihintay ng dagdag na data. Huling 10 segundo lang ang available; hindi na makukuha ang audio na tumugtog bago nagsimulang makinig. Error kapag kulang ang history o hindi available ang recorder. Hindi sapat ang katahimikan para patunayang hinaharang ng source app ang capture.

Syntax

Audio.recent(duration_ms)

Mga parameter

PangalanPaglalarawan
duration_msNumber (1..10000)
Kailangang buong bilang ang tagal, mula 1 hanggang 10000 millisecond.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Halimbawa

# Dapat nagpe-play ang source app; panatilihin ang hindi bababa sa 500 ms na history
Audio.start()
wait(600)
clip = Audio.recent(500)
print(clip.duration_ms)

Audio.match

Hanapin ang pinakakatulad na bahagi ng sample sa audio na ito at ibalik ang similarity score. Hindi tugma ang katahimikan; bumababa ang puntos kapag may kulang na bahagi ng tunog. Error kung mas mahaba ang sample kaysa audio. Hindi nito kinikilala ang pananalita o inaayos ang bilis at tono. Pumili ng threshold gamit ang magkakahiwalay na recording at suriin muli matapos i-update ang matcher.

Syntax

audio.match(sample, threshold)

Mga parameter

PangalanPaglalarawan
sampleAudio
Reference na audio value na hahanapin sa loob ng audio value na ito.
Kailangan · Ayon sa posisyon o pangalan
Walang default
thresholdNumber (0..1)
Kailangang finite na bilang mula 0 hanggang 1. I-calibrate gamit ang magkakahiwalay na recording; halimbawa lang ang 0.85, hindi pangkalahatang inirerekomendang threshold.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

Halimbawa

# I-save ang alert sample sa Template Manager bago patakbuhin ang halimbawang ito
sample = Audio("alert")
Audio.start()
wait(1500)
clip = Audio.recent(1500)
result = clip.match(sample, 0.85)
print(result)
Audio.stop()

Audio.find

Hintayin ang sample na ito sa bagong audio at ibalik ang AudioMatch na umabot sa threshold, o None kung natapos ang recording window nang walang tugma. Audio lang na natanggap matapos magsimula ang tawag ang hinahanap; hindi garantisado ang pagkilala. Nagsisimulang makinig kung kailangan, sa parehong kondisyon ng Audio.start(), at nagpapatuloy hanggang Audio.stop() o matapos ang macro. Maaaring matapos ang pagproseso lampas timeout_ms. Ang 0 ay nagbabalik ng None nang hindi nagsisimulang mag-record. Itinatapon ng Pause ng macro ang nakabinbing audio at pinapahinto ang timeout; bagong audio ang hinahanap sa Resume. Error ang pagkawala ng capture, sobrang data o sirang audio, hindi None.

Syntax

audio.find(timeout_ms, threshold)

Mga parameter

PangalanPaglalarawan
timeout_msNumber (0..2147483647)
Kinakailangang buong bilang mula 0 hanggang 2147483647 millisecond. Hindi kasama ang oras ng pag-pause ng macro. Tinataya lang ang recording window; maaaring matapos ang pagproseso nang mas huli.
Kailangan · Ayon sa posisyon o pangalan
Walang default
thresholdNumber (0..1)
Kailangang finite na bilang mula 0 hanggang 1. I-calibrate gamit ang magkakahiwalay na recording; halimbawa lang ang 0.85, hindi pangkalahatang inirerekomendang threshold.
Kailangan · Ayon sa posisyon o pangalan
Walang default

Ibinabalik na halaga

AudioMatch | None

Halimbawa

# Maghintay ng bagong tunog at pangasiwaan ang timeout
audio = Audio("alert")
result = audio.find(timeout_ms=5000, threshold=0.85)
if result is not None:
    print(result.score, result.start_ms, result.end_ms)
Audio.stop()