跳转到: 导航, 搜索
(SDK功能特性)
 
(未显示6个用户的34个中间版本)
第1行: 第1行:
新浪微博已融入到大众日常生活中,且具有用户群体大、粘性高的显著特点。随着网络环境和移动终端功能的不断完善,微博用户随时随地获取、分享信息的需求激增,同时也为移动应用创造了无限的想象和发展空间。
+
=移动客户端接入=
  
 +
<div class="wiki_txtJ">
 +
为方便移动应用接入微博,微博开放平台提供了移动SDK及相关接口相结合的模式。微博移动SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,集成用微博账号登录、分享到微博能功能,同时优化了WebView,使第三方应用在登录、分享时有了更好的用户体验。
 +
</div>
  
为方便移动应用接入新浪微博,微博平台提供了相关接口及个性化的产品结合模式,并不断优化微博移动端解决方案,提供更多定制化、个性化服务。这将是移动应用的一个全新时代,我们希望与您一同创造出更多有吸引力和个性化的新产品。
 
  
  
官方移动应用SDK,竭在方便移动应用开发者更快捷地接入新浪微博开放平台,使用微博API及平台服务。V2.1版SDK在之前SSO授权,接口封装的基础上,增强了对官方微博客户端的开放,使第三方应用具备调用发博,集成至附件栏等功能模块。
+
=SDK功能特性=
  
 +
<div class="wiki_txtJ">
 +
'''用微博账号登录'''
 +
</div>
  
=SDK功能特性=
 
1、SSO授权
 
  
接入新浪微博的第三方Android、iOS应用可通过新浪微博官方客户端快速完成OAuth2.0授权。
+
<div class="wiki_txtJ">
不需要重复输入新浪微博用户名、密码,只需要一步操作,直接点击授权按钮即可完成授权,增强了操作简便性及帐号安全性。
+
微博SDK支持原生、H5多场景下的授权登录,在用户安装有微博客户端的前提下,原生授权登录流程仅需一步,中间没有H5页面加载,十分快捷。
  
  
SSO授权目的是简化授权流程,读取当前用户登录在客户端上的身份来实现免登录,只需要点击操作就可以完成新浪帐号在第三方应用登录,降低中间的流失率。
+
{{Img_polaroid|src=https://weiboblog-wordpress.stor.sinaapp.com/uploads/2015/01/image0051-600x308.png}}
  
  
SSO授权升级至2.0后,更加关注开发者自身的应用安全,客户端无需在本地存储新浪应用的APPSECRET,验证应用需要用到包名和签名(签名仅针对Android)。
+
对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android)
  
  
SSO授权流程示例图:
+
用户没有安装微博客户端的情况下,需要使用H5页完成授权,用户可能需要先登录微博。
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72207.png}}
+
  
 
2、微博原生分享
 
  
原生分享(Native Share),即通过调用官方微博客户端的发博器,来实现发送微博的功能。
+
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72207.png}}
  
  
当前支持两种形式:唤起分享和集成分享。
+
授权机制请参考授权技术说明文档:[[授权机制|授权机制]]
 +
</div>
  
  
a) 唤起分享:从第三方应用选择内容分享到微博
 
  
 +
<div class="wiki_txtJ">
 +
'''分享到微博'''
 +
</div>
  
下图为唤起分享的流程:
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72208.png}}
 
发布微博后的来源文案:第三方应用
 
  
 +
<div class="wiki_txtJ">
 +
SDK提供了原生、H5多种分享方式供开发者自由选择,无论用户手机中是否安装了微博客户端,用户都能顺利分享。
  
b) 集成分享(需要合作接入,平台BD联系方式参见文档末尾):
 
集成分享是从官方微博客户端中唤起第三方应用,实现分享过程。
 
  
 +
原生唤起分享的流程,发布后微博来源显示第三方应用名称。
  
要实现集成分享首先要用户添加第三方应用到附件栏
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72209.png}}
 
从微博发布页呼起第三方应用,选择内容分享到微博
 
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72210.png}}
+
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72208.png}}
发布微博后的来源文案:官方微博客户端
+
  
  
注意:接入集成分享的第三方,需要在分享后回到官方客户端。
+
分享链接LinkCard解析,在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊链接,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。
  
  
3、LinkCard解析
+
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72211.png}}
  
什么是LinkCard:在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊短链,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72211.png}}
 
  
=SDK版本支持=
+
分享链接LinkCard解析,需要深度合作的第三方才能接入,请有需求的第三方联系微博开放平台。
 +
</div>
  
SDK v2.1已经发布了支持iPhone和Android的版本,需搭配官方客户端3.5.0及以上版本使用。
 
  
iPad和Windows Phone请下载SDK v2.0。
 
  
SDK下载地址:http://open.weibo.com/wiki/SDK
+
==SDK版本支持==
  
  
=SDK接入流程=
+
===iOS SDK===
  
===新应用===
+
<div class="wiki_txtJ">
 +
目前最新版本的 iOS SDK 为 3.3.3,针对苹果应用商店对采集 IDFA 的审核问题,最新版 iOS SDK 去除了采集 IDFA 等隐私信息的代码,使开发者集成 iOS SDK 时,能够顺利的通过苹果应用商店的审核。
 +
</div>
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72205.png}}
 
  
1、注册成为开发者,创建移动应用
+
<div class="wiki_taglist">
 +
<ul class="clearfix">
 +
<li style="font-size:14px;">[[移动客户端接入#SDK接入流程|SDK接入流程]]</li>
 +
<li style="font-size:14px;">[https://github.com/sinaweibosdk/weibo_ios_sdk iOS SDK下载]</li>
 +
</ul>
 +
</div>
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72203.png}}
 
  
如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 : http://open.weibo.com/wiki/%E6%96%B0%E6%89%8B%E6%8C%87%E5%8D%97
+
 
 +
===Android SDK===
 +
 
 +
<div class="wiki_txtJ">
 +
目前最新版本的 Android SDK 为 12.5.0,按照工信部关于个人隐私保护的要求,最新版 Android SDK 已经去除了采集相关设备信息的代码,使开发者集成 Android SDK 时,能够顺利的通过各大应用商店的审核。
 +
</div>
 +
 
 +
 
 +
<div class="wiki_taglist">
 +
<ul class="clearfix">
 +
<li style="font-size:14px;">[[移动客户端接入#SDK接入流程|SDK接入流程]]</li>
 +
<li style="font-size:14px;">[https://github.com/sinaweibosdk/weibo_android_sdk/tree/master/2019SDK Android SDK下载]</li>
 +
</ul>
 +
</div>
 +
 
 +
 
 +
 
 +
==SDK接入流程==
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
'''1、注册成为开发者,创建移动应用'''
 +
</div>
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 :[[新手指南]]
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72205.png}}
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72203.png}}
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72201.png}}
 +
 
  
 
创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。
 
创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72201.png}}
+
</div>
  
2、创建应用完成后,可以在“我的应用 - 应用信息”中查看您所创建应用的APPKEY及APPSECRET,请妥善保管您的这些信息,这将
 
成为您调用新浪微博开放平台各API的身份标志,如下图所示:
 
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd411.png}}
 
  
 +
<div class="wiki_txtJ">
 +
'''2、创建应用完成后,进行SDK配置'''
 +
</div>
  
3、请在“我的应用 - 应用信息 - 高级信息”中填写您的应用回调页,这样才能使OAuth2.0授权正常进行。如果您的APPSECRET发生泄露,您也可以通过该页面中的重置按钮对其重置,如下图所示:
 
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}}
+
<div class="wiki_txtJ">
 +
在 “我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台API的身份标志:
  
注:通常Mobile Native App没有服务器回调地址,您可以在应用控制台授权回调页处填写平台提供的默认回调页,该页面用户不可见,仅用于获取access token。
 
OAuth2.0客户端默认回调页:https://api.weibo.com/oauth2/default.html
 
  
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd411.png}}
  
4、在“我的应用 - 应用信息”填写应用的平台信息
 
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72204.png}}
 
  
这里iPhone应用填写Apple ID和Buddle ID,Android应用填写包名,签名及下载地址。
+
在 “我的应用 - 应用信息 - 高级信息” 中填写您的应用回调页,这样才能使SDK的授权流程正常进行。如果您的APP SECRET发生泄露,您也可以通过该页面中的重置按钮对其重置:
  
关于各字段含义在控制台中均有说明。
 
  
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd5.jpg}}
  
5、下载并集成对应平台SDK到你的应用中,当您开发完您的应用后,您就可以通过“我的应用”页面提交审核了。只有当您的应用通过审核后,才能在微博中正确显示您的来
 
*源地址等。
 
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd611.png}}
+
注:通常移动客户端没有网页回调地址,您可以在回调页地址处填写微博开放平台提供的默认回调页,该页面用户不可见,仅用于完成SDK授权流程。微博移动SDK默认回调页:<nowiki>https://api.weibo.com/oauth2/default.html</nowiki>
  
  
6、您可以通过“我的应用 – 数据统计”页面查看您的应用的相关统计数据,包括应用统计、接口统计、用户特征统计等信息。
+
在 “我的应用 - 应用信息” 填写您的移动应用的平台信息,iPhone 应用填写 Apple ID 和 Buddle ID,Android 应用填写包名,签名及下载地址(各字段含义在填写表单中均有说明)。
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/khd6.jpg}}
 
  
===已上线应用===
+
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/sdk72204.png}}
 +
</div>
 +
 
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
'''3、下载并集成对应平台的微博移动SDK到你的应用中'''
 +
</div>
 +
 
 +
 
 +
<div class="wiki_txtJ">
 +
当您开发完您的应用后,您就可以通过 “我的应用” 页面提交审核了。只有当您的应用通过审核后,才能让除测试账号之外的微博用户使用微博账号登录您的移动客户端,并在微博中正确显示您的来源地址等。
 +
 
 +
 
 +
{{Img_polaroid|src=https://www.sinaimg.cn/blog/developer/wiki/khd611.png}}
 +
</div>
  
{{center|http://www.sinaimg.cn/blog/developer/wiki/sdk72206.png}}
 
  
请直接编辑“我的应用 – 应用信息”补充应用平台信息,改字段修改后立即生效,无需二次审核。
 
  
 
==移动应用商务合作==
 
==移动应用商务合作==
移动SDK中的LinkCard和附件栏集成分享权限需要合作申请,商务对接请发邮件至:[mailto:yuqing1@staff.sina.com.cn yuqing1@staff.sina.com.cn]
+
 
 +
移动SDK中的LinkCard权限需要合作申请,商务对接请发邮件至:[mailto:zhangdi2@staff.weibo.com zhangdi2@staff.weibo.com]、[mailto:siqin1@staff.weibo.com siqin1@staff.weibo.com]、[mailto:lingxia@staff.weibo.com lingxia@staff.weibo.com]
 +
 
 +
 
  
 
==SDK常见使用问题==
 
==SDK常见使用问题==
1、应用无法唤起新浪微博客户端
 
应用无法唤起新浪微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。
 
  
2、唤起微博客户端分享,分享完后无法回到第三方应用
+
1、应用无法唤起微博客户端
第三方应用需要自行处理分享完成后的唤起地址,具体方式可参考SDK中附带的DEMO。
+
 
 +
应用无法唤起微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。
 +
 
 +
 
 +
 
 +
 
 +
 
  
 +
{{#a:nobtns|noheading}}
 
__NOTOC__
 
__NOTOC__

2023年2月1日 (三) 14:13的最后版本

移动客户端接入

为方便移动应用接入微博,微博开放平台提供了移动SDK及相关接口相结合的模式。微博移动SDK,竭在方便移动应用开发者更快捷地接入微博开放平台,集成用微博账号登录、分享到微博能功能,同时优化了WebView,使第三方应用在登录、分享时有了更好的用户体验。


SDK功能特性

用微博账号登录


微博SDK支持原生、H5多场景下的授权登录,在用户安装有微博客户端的前提下,原生授权登录流程仅需一步,中间没有H5页面加载,十分快捷。



对移动应用提供授权刷新机制,使用微博SDK的第三方应用,可获得Refresh Token权限,实现一次授权,更长的有效期。集成微博移动SDK后,第三方需要更加关注自身应用的安全性,第三方客户端无需在本地存储微博开放平台的APP SECRET,验证应用需要用到包名和签名(签名仅针对Android)


用户没有安装微博客户端的情况下,需要使用H5页完成授权,用户可能需要先登录微博。



授权机制请参考授权技术说明文档:授权机制


分享到微博


SDK提供了原生、H5多种分享方式供开发者自由选择,无论用户手机中是否安装了微博客户端,用户都能顺利分享。


原生唤起分享的流程,发布后微博来源显示第三方应用名称。



分享链接LinkCard解析,在微博消息流内,分享一条链接,该链接将解析为包含一个对象数据的特殊链接,且该对象数据可以在微博消息流内显示并交互,这种形态就是微博消息流LinkCard解析。



分享链接LinkCard解析,需要深度合作的第三方才能接入,请有需求的第三方联系微博开放平台。


SDK版本支持

iOS SDK

目前最新版本的 iOS SDK 为 3.3.3,针对苹果应用商店对采集 IDFA 的审核问题,最新版 iOS SDK 去除了采集 IDFA 等隐私信息的代码,使开发者集成 iOS SDK 时,能够顺利的通过苹果应用商店的审核。



Android SDK

目前最新版本的 Android SDK 为 12.5.0,按照工信部关于个人隐私保护的要求,最新版 Android SDK 已经去除了采集相关设备信息的代码,使开发者集成 Android SDK 时,能够顺利的通过各大应用商店的审核。



SDK接入流程

1、注册成为开发者,创建移动应用


如果你还不是一名开发者,请先注册成为开发者,具体参考新手指南 :新手指南





创建应用时,开发者需要谨慎选择应用对应平台,不同的平台建议使用不同APPKEY开发。


2、创建应用完成后,进行SDK配置


在 “我的应用 - 应用信息” 中查看您所创建应用的 APPKEY 及 APP SECRET,请妥善保管您的这些信息,这将成为您集成SDK、调用微博开放平台API的身份标志:



在 “我的应用 - 应用信息 - 高级信息” 中填写您的应用回调页,这样才能使SDK的授权流程正常进行。如果您的APP SECRET发生泄露,您也可以通过该页面中的重置按钮对其重置:



注:通常移动客户端没有网页回调地址,您可以在回调页地址处填写微博开放平台提供的默认回调页,该页面用户不可见,仅用于完成SDK授权流程。微博移动SDK默认回调页:https://api.weibo.com/oauth2/default.html


在 “我的应用 - 应用信息” 填写您的移动应用的平台信息,iPhone 应用填写 Apple ID 和 Buddle ID,Android 应用填写包名,签名及下载地址(各字段含义在填写表单中均有说明)。



3、下载并集成对应平台的微博移动SDK到你的应用中


当您开发完您的应用后,您就可以通过 “我的应用” 页面提交审核了。只有当您的应用通过审核后,才能让除测试账号之外的微博用户使用微博账号登录您的移动客户端,并在微博中正确显示您的来源地址等。



移动应用商务合作

移动SDK中的LinkCard权限需要合作申请,商务对接请发邮件至:zhangdi2@staff.weibo.comsiqin1@staff.weibo.comlingxia@staff.weibo.com


SDK常见使用问题

1、应用无法唤起微博客户端

应用无法唤起微博客户端实现分享,主要是因为程序中的APPKEY,包名和签名(仅限Android)信息和在平台填写的不一致。





文档更新时间: 2023-02-01