本教程目的在于让大家熟悉并掌握各种API的使用。

可下载运行SmobilerTutorials测试

一、手势

1.创建手势

                C#：
                 this.Client.Pattern.Create((obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                        {
                            this.Client.Pattern.Password = args.Password;
                            Toast(args.Password);
                        }
                    });
            

2.本地验证手势

                 C#：
                 this.Client.Pattern.VerifyLocal((obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                            Toast("Sucess");
                    });
            

3.服务端验证手势

                C#：
                 this.Client.Pattern.VerifyServer((obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                            Toast(args.Password);
                    });
            

二、分享

进行资源信息的分享，包括url链接、文本信息。

调用代码：Client.Share.SendURL("http://smobiler.com/");

语法：Client.Share.SendURL(分享地址);

Client.Share.SendText(文本内容);

三、通讯录

1.显示通讯录

this.Client.Contacts.Show();

2.添加通讯录

this.Client.Contacts.Add("smobiler", "18888888888", "smobiler@smobiler.com");

3.获取通讯录

                   C#：
                     this.Client.Contacts.GetContactEnties((obj, args) =>
                    {
                        if (args.isError == true)
                        {
                            MessageBox.Show(args.error);
                        }
                        else
                        {
                            MessageBox.Show(string.Format("共计：{0}", args.Value.Count));
                        }
                    });
            

四、资源

1.资源加载

                   C#：
                    this.Client.Resource.Load(System.IO.Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "resources.zip"), (obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                            Toast("Done");
                    });
            

2.资源获取（所有包含c的资源）

                   C#：
                   this thisClient.Resource.Get(new Smobiler.Core.RPC.ClientResourceFilter("*c*", ""), (obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                        {
                            List list = new List();
                            foreach (Smobiler.Core.RPC.ClientResourceArgs.ResourceData data in args.Resouces)
                            {
                                list.Add(string.Format("{0}/{1}/{2}", data.ResourceID, data.ResourceSize, data.ResourceDate));
                            }
                            MessageBox.Show(string.Format("数量{0}\r\n{1}", args.Count, string.Join("\r\n", list.ToArray())));
                        }
                    });
            

3.资源删除（1.png，2.png，3.png）

                   C#：
                  this.Client.Resource.Remove(new string[] { "1.png", "2.png", "3.png" }, MobileResourceManager.DefaultImageResourceName, (obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                            Toast(args.Count.ToString());
                    });
            

4.资源删除（所有包含c的资源）

                   C#：
                  this.Client.Resource.Remove(new Smobiler.Core.RPC.ClientResourceFilter("*c*", ""), (obj, args) =>
                    {
                        if (args.isError == true)
                            Toast(args.error);
                        else
                            Toast(args.Count.ToString());
                    });
            

五、文件

1.文件下载

this.Client.File.Download("领用单.doc", MobileResourceManager.DefaultDocumentResourceName, (obj, args) => { this.Toast(args.isError.ToString()); });

2.文件删除

this.Client.File.Delete("领用单.doc", MobileResourceManager.DefaultDocumentResourceName, (obj, args) => { this.Toast(args.isError.ToString()); });

3.文件打开

this.Client.File.Open("领用单.doc", MobileResourceManager.DefaultDocumentResourceName, (obj, args) => { this.Toast(args.isError.ToString()); });

4.文件列表

this.Client.File.List((obj, args) => { this.Toast(args.Count.ToString()); });

5.文件是否存在

this.Client.File.Exists("领用单.doc", MobileResourceManager.DefaultDocumentResourceName, (obj, args) => { this.Toast(args.Exists.ToString()); });

6.文件上传

                  C#：
              this.Client.File.Upload((obj, args) =>
                    {
                        if (args.isError == false)
                        {
                            args.SaveFile();
                            this.Toast(string.Format("{0}", args.ResourceID));
                        }
                        else
                        {
                            Toast(args.error);
                        }
                    });

六、数据库（Client.Sqlite）

1.打开数据库

                   C#：
                  this.Client.SQLite.OpenOrCreate(new Smobiler.Core.RPC.SQLiteDataBase("oudi.db"), (obj, args) =>
                    {
                        if (args.isError == true)
                            MessageBox.Show(args.error);
                        else
                            Toast("OpenDataBase sucess");
                    });
            

2.设置数据库

                   C#：
                   this.Client.SQLite.Execute(new string[] { "create table IF NOT EXISTS tbloudi (ID INT PRIMARY KEY     NOT NULL,NAME           TEXT    NOT NULL )", "insert into tbloudi values(" + DateTime.Now.Millisecond + ",'oudi')" }, (obj, args) =>
                    {
                        if (args.isError == true)
                            MessageBox.Show(args.error);
                        else
                            Toast("SetDataBase sucess");
                    });
            

3.获取数据库

                C#：
                    this.Client.SQLite.Read("select * from tbloudi", (obj, args) =>
                    {
                        if (args.isError == true)
                            MessageBox.Show(args.error);
                        else
                            Toast(args.Data.Rows.Count.ToString());
                    });
            

4.关闭数据库

                   C#：
                 this.Client.SQLite.Close(new Smobiler.Core.RPC.SQLiteDataBase("oudi.db"), (obj, args) =>
                    {
                        if (args.isError == true)
                            MessageBox.Show(args.error);
                        else
                            Toast("CloseDataBase sucess");
                    });
            

5.删除数据库

                   C#：
                    this.Client.SQLite.Delete(new Smobiler.Core.RPC.SQLiteDataBase("oudi.db"), (obj, args) =>
                    {
                        if (args.isError == true)
                            MessageBox.Show(args.error);
                        else
                            Toast("DeleteDataBase sucess");
                    });
            

七、客户端信息

1.获取客户端内核版本号

Toast(this.Form.Client.CoreVersion.ToString());

注：获取的是云平台打包页上的内核版本

2.获取客户端设备名称

Toast(this.Form.Client.Device);

3.获取设备编号

Toast(this.Form.Client.DeviceID);

4.获取客户端操作系统

Toast(this.Form.Client.DeviceOS);

5.获取客户端操作系统版本号

Toast(this.Form.Client.DeviceOSVersion);

6.获取和设置一个值，该值表示是否启用客户端界面栈

Toast(this.Form.Client.EnableStackView.ToString());

7.获取客户端网络端点

Toast(this.Form.Client.IPEndPoint.ToString());

8.获取客户端最后一次操作时间

Toast(this.Form.Client.LastDate.ToString());

9.获取设备屏幕密度

Toast(this.Form.Client.ScreenDensity.ToString());

10.获取设备屏幕分辨率

Toast(this.Form.Client.ScreenSize.ToString());

11.获取客户端会话编号

Toast(this.Form.Client.SessionID);

12.获取客户端第一次连接时间

Toast(this.Form.Client.StartDate.ToString());

13.获取和设置用户会话编号

Toast(this.Form.Client.UserSessionID);

14.获取客户端版本号

Toast(this.Form.Client.Version.ToString());

注：获取的是云平台打包页上的版本

15.关闭客户端

this.Form.Client.Exit();

16.关闭客户端并终止服务端会话

this.Form.Client.ExitAndQuit();

八、关于页

1.显示权限页

this.Client.ShowPermission();

2.显示离线资源页

this.Client.ShowOfflineResources();

3.显示网络诊断页

this.Client.ShowNetworkDiagnosis();

4.显示关于页

this.Client.ShowAbout();

九、其他

1.获取当前网络类型

                   C#：
                      this.Client.GetNetWorkType((obj, args) =>
                    {
                        if (args.isError == true)
                        {
                            MessageBox.Show(args.error);
                        }
                        else
                        {
                            MessageBox.Show(args.NetWorkType.ToString());
                            //args.WifiBSSID 获取bssid   仅限Android
                            //args.WifiIP  获取ip
                            //args.WifiSSID 获取ssid 
                       }
                    });
            

2.获取状态栏高度

                   C#：        
                this.Client.GetStatusbarHeight((obj, args) =>
                    {
                        if (args.isError == true)
                        {
                            MessageBox.Show(args.error);
                        }
                        else
                        {
                            MessageBox.Show(args.Height.ToString());
                        }
                    });

3.播放音频

this.Client.PlayAudio("001.mp3", AppDomain.CurrentDomain.BaseDirectory);

PlayAudio的第二个参数AppDomain.CurrentDomain.BaseDirectory 表示的是bin\debug, 001.mp3是在bin\debug目录下

4.停止播放音频

this.Client.StopAudio();

5.发送邮件

调用手机邮箱功能进行发送邮件。

调用代码：Client.SendEmail("请假","今天身体不舒服，请个假","627573361@qq.com");

语法：Client.SendEmail(邮件标题,邮件内容,收件人邮箱);

6.发送短信

调用手机的发送短信功能进行短信发送。

调用代码：Client.SendSMS("11","10086");

语法：Client.SendSMS(发送信息,发送号码)

7.拨打电话

调用手机的拨号功能进行拨打电话。

调用代码：Client.TelCall("10086");

语法：Client.TelCall(拨打号码)

8.跳转网页

调用默认浏览器进行网页跳转。

调用代码：RedirectUrl("http://smobiler.com/");

RedirectUrl("http://smobiler.com/",true);// 第二个参数设置在Web模式下是否打开新的Tab标签页

语法：RedirectUrl(跳转网址)

9.蓝牙

调用手机蓝牙功能，进行蓝牙打开判断，蓝牙设置。

1. 蓝牙打开判断，代码如下：

                C#：
                    private void btnOpenBule_Press(object sender, EventArgs e)
                    {
                        try
                        {
                            this.Client.Bluetooth.IsOpen((object　obj, Smobiler.Core.RPC.BluetoothManagerIsOpenArgs args) =>
                            {
                                if (args.IsOpen == true)
                                    Toast("Open");
                                else
                                    Toast("Not Open");
                            });
                        }
                        catch(Exception ex)
                        {
                            Toast(ex.Message, ToastLength.SHORT);
                        }
                    }

2. 打开手机蓝牙设置界面，进行蓝牙设置，代码如下：

                C#：
                    private void btnShow_Press(object sender, EventArgs e)
                    {
                        try
                        {
                            this.Client.Bluetooth.Show();                       
                        }
                        catch(Exception ex)
                        {
                            Toast(ex.Message, ToastLength.SHORT);
                        }
                    }

10.获取粘贴板内容

this.Client.GetClipboard((obj, args) => { if (args.isError == true) Toast("isError: " + args.isError.ToString()); else Toast(args.Data); });

11.设置粘贴板内容

this.Client.SetClipboard(DateTime.Now.ToString(), (obj, args) => { Toast("isError: " + args.isError.ToString()); });

12.清除缓存

this.Client.ClearCache((obj, args) => { if (args.isError == false) Toast("清除成功"); else Toast(args.error); });

13.Socket

调用代码：

创建Socket：MobileSocket socket = this.Client.Socket.Create(this.Client.HostAddress, this.Client.HostTcpPort);

Socket连接：socket.Connect(MobileSocketEventHandler connectHandler);

Socket发送数据：socket.Send(byte[] data, MobileSocketEventHandlersendHandler);

Socket获取状态：socket.IsOpen(MobileSocketIsOpenEventHandler isopenHandler);

Socket关闭连接：socket.Close(MobileSocketEventHandler closeHandler);

完整代码参考：demo

14.通过浏览器打开Smobiler应用

在4.8版本可通过浏览器打开smobiler应用，唤醒地址为smobiler+云平台应用ID://url/自定义参数 。比如应用ID为20，那么打包后可使用 smobiler20://url/params1/params2，如下图，在手机端打开网页点击跳转即可打开smobiler应用

在服务端可在MobileGlobal.cs文件中通过 UrlLinking方法获取这两个参数。

                    C#：
                        public static void OnSessionStart(object sender, SmobilerSessionEventArgs e)
                        {
                            e.Client.UrlLiking += (obj, args) =>
                            {
                                //把obj转换为ClientVariables
                                ClientVariables client = obj as ClientVariables;
                                //获取当前激活的窗体
                                Smobiler.Core.Controls.MobileForm form = client.GetActiveForm();
                                //当前窗体上弹出MessageBox
                                form.MessageBox.Show(string.Join("/", args.UrlParams));
                            };
                        }

15.保存到系统相册

1. 保存保存当前应用资源路径

调用代码：this.Client.SaveImageToAlbum("logon.png", MobileResourceManager.DefaultImageResourceName);

语法：this.Client.SaveImageToAlbum(图片名称, 图片路径);

2. 保存网络资源

调用代码：this.Client.SaveImageToAlbum("https://www.smobiler.com/images/index/logo.png");

语法：this.Client.SaveImageToAlbum(图片链接);

16.全局计时器

调用代码：

开始 this.Client.Timer.Start(1,(obj,args)=>{ Toast("ClientGloablTimer" + DateTime.Now.ToString());});//Start方法后面第1个参数为触发间隔的秒，第二个参数是Tick回调

停止 this.Client.Timer.Stop();

17.系统震动

调用代码：

this.Client.Vibrate();

18.系统铃声

调用代码：

this.Client.PlaySystemSound(Smobiler.Core.Protocol.SystemSoundType.Alarm, 0);

19.心跳

调用代码：

                    C#：
                        //心跳开启
                        //interval 心跳间隔（毫秒）,handler 超时回调 ，intervalHandler 心跳回调
                        this.Client.HeartBeatEnable(5000,
                        (obj, args) =>
                        {
                            //心跳超时时触发
                        }, (obj, args) =>
                        {
                            //每次心跳时触发
                        });
                        //心跳关闭
                        this.Client.HeartBeatDisable();
                    

更多重载见：帮助文档