瞩目集成使用指导
日期 |
版本 |
修改 |
备注 |
20161117 |
Rtc-stack |
|
|
20161207 |
Rtc-stack
(3.6.11208.1104)
|
修改 sdk 初始化接口 |
初始化接口必须赋值参数:
【WEB_DOMAIN ,APP_KEY,APP_SECRET】
否则初始化失败,来源请咨询相提供者索要
|
20170207 |
Rtc-stack
(4.0.21721.0118)
|
1.支持加入研讨会会议和小组成员;
2.添加水印“缩放”
3.支持没有音频的启动/加入会议;
4.支持启动/参加会议没有视频;
5.提供一个选项来显示/隐藏缩略图,
同时观看屏幕共享会议;
6.提供一个选项来显示/隐藏主机中的
“离开会议”项目;
|
|
关于 Demo 和接口
解压后的压缩包包含两个文件夹
zhumu-mobilertc-adt 和 zhumu-mobilertc-android-studio ,里面分别有各自引用的工程库及Demo;
Demo 包含两个:
example1 和 example2,简介如下,具体详情请参见 demo 实现。
example1 实现:
1. 初始化,开启/加入会议的接口使用;
2. 自定义邀请 Activity,获取邀请 url、主题等数据;
3. 加入未开启会议的等待 Activity 实现。
example2 实现:
视频界面自定义按钮
与服务器的交互,请参见 API 文档
多 SDK 接口请参考各自的 doc:
/zhumu-mobilertc-adt/doc 或者 /zhumu-mobilertc-android-studio/doc
For Android Studio
创建项目后,在项目中引用 Modules :
zmmobilertc
zmcommonlib
zmsdk
For ADT
Import zhumu-common-lib 和 zhumu-mobilertc 作为第三方库引用
SDK 初始化
ZmSDK zmSDK = ZmSDK.getInstance() ;
//zmSDK.initSDK( this, this) ;
// APP_KEY, APP_SECRET, WEB_DOMAIN 必须赋值,否则初始化失败,来源请咨询相提供者索要
zmSDK.initSDK( this, APP_KEY, APP_SECRET, WEB_DOMAIN, this ) ; //
开启会议
创建 ZmMeetingService :
ZmSDK zmSDK = ZmSDK.getInstance();
if(!zmSDK.isInitialized())
{ //Error message
return;
}
ZmMeetingService meetingService = zmSDK.getMeetingService();
Start Meeting: Sdk 初始化成功可以开启一个会议
ZmStartMeetingOptions opts = new ZmStartMeetingOptions();
//opts.no_driving_mode = true;
//opts.no_invite = true;
//opts.no_meeting_end_message = true;
//opts.no_titlebar = true;
//opts.no_bottom_toolbar = true;
//opts.no_dial_in_via_phone = true;
//opts.no_dial_out_to_phone = true;
//opts.no_disconnect_audio = true;
//opts.no_share = true;
//opts.invite_options = ZmInviteOptions.INVITE_ENABLE_ALL;
//opts.meeting_views_options = ZmMeetingViewsOptions.NO_BUTTON_SHARE + ZmMeetingViewsOptions.NO_BUTTON_VIDEO;
//opts.no_audio = true;
//opts.no_video = true;
//opts.no_meeting_error_message = true;
// ……………
int ret = meetingService.startMeeting(this, meetingNo, opts);
加入会议
Sdk 初始化成功可以加入一个会议
ZmSDK zmSDK = ZmSDK.getInstance();
if(!zmSDK.isInitialized()) {
//Error message
return;
}
ZmMeetingService meetingService = zmSDK.getMeetingService();
ZmJoinMeetingOptions opts = new ZmJoinMeetingOptions();
//opts.no_driving_mode = true;
//opts.no_invite = true;
//opts.no_meeting_end_message = true;
//opts.no_titlebar = true;
//opts.no_bottom_toolbar = true;
//opts.no_dial_in_via_phone = true;
//opts.no_dial_out_to_phone = true;
//opts.no_disconnect_audio = true;
//opts.no_share = true;
//opts.invite_options = ZmInviteOptions.INVITE_VIA_EMAIL + ZmInviteOptions.INVITE_VIA_SMS;
//opts.meeting_views_options = ZmMeetingViewsOptions.NO_BUTTON_SHARE;
//opts.no_audio = true;
//opts.no_video = true;
//opts.no_meeting_error_message = true;
//opts.participant_id = "participant id";
// ……………
int ret = meetingService.joinMeeting(this, meetingNo, DISPLAY_NAME, meetingPassword, opts);
Meeting Service 监听:
Register ZmetingServiceListener 获取 meeting event
更多的接口请看 API doc
自定义 InviteActivity
<activity android:name="suirui.zhumu.sdkexample.MyInviteActivity"
android:label="@string/invite_acitivity_name"
android:icon="@drawable/ic_launcher"
android:theme="@style/ZMTheme.MainWindow">
<intent-filter>
<action android:name="suirui.zhumu.sdkexample.intent.action.MeetingInvite" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
修改包名:action 包名为自己项目包名:
packageName + “.intent.action.MeetingInvite”.
/**
* 此为自定义界面
* 视频界面 点击‘参与者’中‘邀请’ 弹出的界面,
*
*
* 在 res/values/config.xml 中配置
*
* 修改为‘true’
* <bool name="zm_config_invite_by_only_action_meeting_invite">true</bool>
*
*
* 修改为当前项目的包名:
<!-- Invitation content generator class. It must implement com.zipow.videobox.util.InviteContentGenerator -->
<string name="zm_config_invite_content_generator">suirui.zhumu.sdkexample.MyI nviteContentGenerator</string>
*
*/
获取 Url,主题等数据:
Intent intent = getIntent();
Uri uri = intent.getData();
String subject = intent.getStringExtra(AndroidAppUtil.EXTRA_SUBJECT);
String text = intent.getStringExtra(AndroidAppUtil.EXTRA_TEXT);
自定义加入未开启会议的等待 Activity
<activity android:name="suirui.zhumu.sdkexample.MyWaitJoinActivity"
android:icon="@drawable/ic_launcher"
android:theme="@style/ZMTheme.MainWindow">
<intent-filter>
<action android:name="suirui.zhumu.sdkexample.intent.action.JoinBeforeHost" />
<category android:name="android.intent.category.DEFAULT" />
</intent-filter>
</activity>
修改包名:action 包名为自己项目包名:
packageName + “.intent.action.JoinBeforeHost”.
获取 Url,主题等数据:
Intent intent = getIntent();
Uri uri = intent.getData();
String topic = intent.getStringExtra(AndroidAppUtil.EXTRA_TOPIC); long
meetingId = intent.getLongExtra(AndroidAppUtil.EXTRA_MEETING_ID, 0);
自定义 MyMeetingActivity
该 Activity 可以自定义 共享 视频开启等按钮,详情参见 example2。
res/values/config.xml 下配置 MyMeetingActivity 的路径:
<resources>
<string name="zm_config_conf_activity">suirui.zhumu.sdkexample2.MyMeetingActi vity<string>
</resources>
MyMeetingActivity 声明参见 AndroidManifest.xml