Instreamatic
Search…
Voice Ads iOS SDK
Voice Ads Android SDK
Voice Ads Web SDK
Active Audio Android Manual
Instreamatic offers consumers the power of a voice command while listening to a digital radio stream. Users can say 'Hey, Radio' and ask to open a webpage, show directions, request a promo code, and more. The ad will deliver an appropriate target action.
To fully enable the App, microphone access permission needs to be activated to your App manifest. You can learn more about how to do this via the following link:
Please note that the application must be developed as a foreground service.
And the foreground service must be launched while the activity is visible.
Microphone access must be declared for foreground service as well.
Please see the link below for reference:
(Please turn off the AdBlocker to access the repository)
Project Configuration
1
repositories {
2
jcenter()
3
mavenCentral()
4
maven {
5
url 'http://instreamatic.com/nexus/repository/maven-public'
6
}
7
}
8
ext {
9
adadapterVersion = '6.2.0'
10
admanVersion = '9.0.0'
11
serVersion = '6.15.0'
12
admanEmbdVersion = '1.1.0'
13
}
14
dependencies {
15
api 'com.instreamatic:adman-android:' + project.ext.admanVersion + '@aar'
16
api 'com.instreamatic:adman-android-view:' + project.ext.admanVersion + '@aar'
17
api 'com.instreamatic:adman-android-voice:' + project.ext.admanVersion + '@aar'
18
api 'com.sensory.speech.snsr:tnl:'+ project.ext.serVersion +'@aar'
19
api 'com.instreamatic.embedded:phrase-spot:' + project.ext.admanEmbdVersion + '@aar'
20
api 'com.instreamatic.embedded:voice-recognition-embedded:' + project.ext.admanEmbdVersion + '@aar'
21
api 'com.instreamatic.adadapter:adadapter-android:' + project.ext.adadapterVersion + '@aar'
22
}
23
}
24
android {
25
...
26
packagingOptions {
27
exclude 'META-INF/DEPENDENCIES.txt'
28
exclude 'META-INF/LICENSE.txt'
29
exclude 'META-INF/NOTICE.txt'
30
exclude 'META-INF/NOTICE'
31
exclude 'META-INF/LICENSE'
32
exclude 'META-INF/DEPENDENCIES'
33
exclude 'META-INF/notice.txt'
34
exclude 'META-INF/license.txt'
35
exclude 'META-INF/dependencies.txt'
36
exclude 'META-INF/LGPL2.1'
37
}
38
39
}
Copied!
Implementation
Create an instance of AdAdpater first
1
AdAdapter adWrap;
2
adWrap = new AdAdapter(this);
Copied!
Then, set up ad request parameters. You can use the same SDK installation for both Voice Ads and Active Audio.
Voice Ads parameters example
1
2
AdmanRequest request = new AdmanRequest.Builder()
3
.setSiteId(1249)
4
.setRegion(Region.GLOBAL)
5
.setType(Type.VOICE)
6
.build();
7
AdmanAdapter admanAdapter = (AdmanAdapter)adWrap.getModule(AdmanAdapter.ID);
8
9
Copied!
Active Audio parameters example
1
AdmanRequest request = new AdmanRequest.Builder()
2
.setSiteId(1976)
3
.setRegion(Region.GLOBAL)
4
.setType(Type.VOR)
5
AdmanAdapter admanAdapter = (AdmanAdapter)adWrap.getModule(AdmanAdapter.ID);
Copied!
If you need to switch between Voice Ads and Active Audio ads, add the following when updating the request parameters
1
admanAdapter.updateRequest(request_builder, true);
Copied!
Usage example:
1
AdmanRequest request = new AdmanRequest.Builder()
2
.setSiteId(1976)
3
.setRegion(Region.GLOBAL)
4
.setType(Type.VOR)
5
admanAdapter.updateRequest(request_builder, true);
6
Copied!
This approach to Active Audio must be used when you are going to play the ad with Instreamatic SDK. If you are going to play it with your own player or insert it into a stream, please see below for detailed instructions.
You can use the default approach for Voice Ads though.
Adding on-device recognition models
On-device recognition models (separate from the wake word):
List of available models for on-device recognition (more to come):
Language
Language Code
Filename
Implementation example:
1
AdmanAdapter admanAdapter = (AdmanAdapter)adWrap.getModule(AdmanAdapter.ID);
2
admanAdapter.addModel("assets/models/spot_hey_radio_enUS.snsr", LanguageCode.ENGLISH_US);
3
VoiceRecognitionEmbedded voiceRecognition = new VoiceRecognitionEmbedded(this);
4
voiceRecognition.addModel("assets/models/large_instrmtc_ovr25_enUS.snsr", LanguageCode.ENGLISH_US);
5
Copied!
If you want to add more models for on-device recognition, add one more VoiceRecognitionEmbedded::addModel with another model.
Ad Request and Playback
This approach to Active Audio must be used when you are going to play the ad with Instreamatic SDK. If you are going to play it with your own player or insert it into a stream, please see below for detailed instructions.
You can use the default approach for Voice Ads though.
Ad Request and Playback for Voice Ads:
1
//App is started.
2
//You are preloading ad at the start of the session
3
//After the init of the SDK you are preloading an ad:
4
adWrap.preload();
5
//wait for an ad placement.
6
//For example it's a pre-roll and 'play' button is pressed:
7
adWrap.sendCanShow();
8
//Here you will need to check if there is an ad available for playback
9
//If the state of Adman is AdmanEvent.Type.READY then ad must be played
10
adWrap.play();
11
//if there is no ad available, return listener to a content and try requesting another ad
Copied!
This is just a single use-case. You can request an ad at another event, but please keep the above sequence unchanged.
Ad Request and Playback for Active Audio:
1
adWrap.start();
Copied!
If your request parameters were set for Active Audio, the above method will request an ad and then play it right away.
Active Audio Request and Playback for server side in-stream insertion
First of all, you need to request an ad from our Ad Server. It can be done via VAST-Tag:
https://x3.instreamatic.com/v5/vast/1976?microphone=1&type=vor&device_id=<gaid/idfa>&gender=<gender>&age=<age>&ip=<ip>&user_id=<userid>&user_agent=<useragent>
Where:
Parameter Name
Description
user_id
Optional user identifier. You can send us your in-app identifıers for better targetıngç
ip
ip address for geo-targeting
gender
Gender parameter for targeting
age
Age parameter for targeting in min-max format
device_id
Advertising identifier. It's possible to put idfa or gaid there.
user_agent
UserAgent of the client application
Example:
https://x3.instreamatic.com/v5/vast/1976?microphone=1&type=vor&device_id=6ce55d7e-f871-4553-8f99-d195f86b0148&gender=F&age=35-40&ip=88.227.61.31&user_id=123567&user_agent=Mozilla/5.0%20(Windows%20NT%206.1;%20Win64;%20x64;%20rv:47.0)%20Gecko/20100101%20Firefox/47.0
x3.instreamatic.com
Instreamatic VOR Ad can be identified by the following values in the VAST Document:
- “instreamatic” in the <AdSystem> tag;
- “![CDATA[ vor ]]” in the “Type” extension
The combination of the two values above indicates the VOR Ad.
The Audio Ad can be found in the <MediaFiles> section of the VAST Document. This is the part for in-stream insertion.
Example:
1
<MediaFiles>
2
<MediaFile id="mp3_192" delivery="progressive" type="audio/mpeg" bitrate="192000" codec="mpeg" maintainAspectRatio="false" scalable="true" width="1" height="1">
3
<![CDATA[ https://dztk6yq65a9he.cloudfront.net/static/creative/audio/D6/30BBAF.mp3 ]]>
4
</MediaFile>
5
<MediaFile id="aac_32" delivery="progressive" type="audio/aac" bitrate="32000" codec="" maintainAspectRatio="false" scalable="true" width="1" height="1">
6
<![CDATA[ https://dztk6yq65a9he.cloudfront.net/static/creative/audio/A8/B775BB.aac ]]>
7
</MediaFile>
8
<MediaFile id="aac_64" delivery="progressive" type="audio/aac" bitrate="64000" codec="" maintainAspectRatio="false" scalable="true" width="1" height="1">
9
<![CDATA[ https://dztk6yq65a9he.cloudfront.net/static/creative/audio/E6/9F2629.aac ]]>
10
</MediaFile>
11
<MediaFile id="mp3_128" delivery="progressive" type="audio/mpeg" bitrate="128000" codec="mpeg" maintainAspectRatio="false" scalable="true" width="1" height="1">
12
<![CDATA[ https://dztk6yq65a9he.cloudfront.net/static/creative/audio/5A/6FA9A1.mp3 ]]>
13
</MediaFile>
14
<MediaFile id="m4a_32" delivery="progressive" type="audio/mp4" bitrate="32000" codec="mp4a.40.2" maintainAspectRatio="false" scalable="true" width="1" height="1">
15
<![CDATA[ https://dztk6yq65a9he.cloudfront.net/static/creative/audio/23/C99567.mp4 ]]>
16
</MediaFile>
17
<MediaFile id="m4a_64" delivery="progressive" type="audio/mp4" bitrate="64000" codec="mp4a.40.2" maintainAspectRatio="false" scalable="true" width="1" height="1">
18
<![CDATA[ https://dztk6yq65a9he.cloudfront.net/static/creative/audio/4F/C20AB8.mp4 ]]>
19
</MediaFile>
20
</MediaFiles>
Copied!
It’s possible to get audio files in different codecs: MP3 192kbps/128kbps, AAC 32kbps/64kbps, m4a 32kbps/64kbps.
Before playing an ad, the XML response must be converted to an array of bytes.
At the ad placement with Active Audio, call the following method:
1
AdmanAdapter.setVASTBytes(byte[] byteArray, boolean startPlaying)
Copied!
Instreamatic SDK will start listening to the wake-word and you'll receive the START_DETECT event.
The SDK will wait for the wake-word while the ad is playing. You can retrieve the ad duration using the below method (if needed):
1
VASTInline vastInline = AdAdapter.getAdmanAdapter().
2
getCurrentAd();
3
VASTInline.duration
Copied!
If SDK will catch the wake-word, it will enable the mic for command recognition. STOP_DETECT event will be reported.
Then the SDK will send the START_RECOGNITION event. This event must be used as an indication of the moment when the stream volume must be lowered.
At the end of the recognition session, the SDK will send the STOP_RECOGNITION event. This event must be used as an indication of the moment when the stream volume must be turned back on.
Don’t forget to call adWrap.sendCanShow on all the ad placements even if there is no ad to play.
Last modified 4mo ago