草庐IT

微信小程序开发实战9_3 小程序URL Scheme

go lang 2023-04-14 原文

为了微信小程序的推广,微信提供了多种小程序入口方式,比如在公众号中可以将已经关联过的小程序的页面放置到自定义菜单中,用户单击后就可以打开小程序的相关页面;或者是给用户发送公众号模板消息,用户点击收到的模板消息进入小程序。不过这些方式都需要微信客户端的支持,有些情况下您可能希望在微信客户端之外的APP中打开小程序,比如您可能通过短信或者邮件给用户发送营销通知,并希望用户在短信或邮件APP中打开小程序,以快速获取用户流量,完成引流、导购等目的。对于这种诉求,微信也给予了支持,下面介绍如何生成URL Scheme以及通过URL Scheme打开小程序的方法。

9.3.1生成小程序URL Scheme码

小程序URL Scheme码,用于短信、邮件、外部网页、微信内等方式拉起小程序的。通过服务端接口urlscheme.generate可以为小程序的任意页面生成小程序URL Scheme码。生成的URL Scheme如下所示:
weixin://dl/business/?t= *TICKET*
接口地址
api.weixin.qq.com/wxa/generatescheme?access_token=[xxx]

请求参数:

  • access_toke:接口调用凭证
  • jump_wxa:跳转到的目标小程序信息。
  • is_expire:生成的URL Scheme码类型,到期失效:true,永久有效:false。
  • expire_time:URL Scheme码的失效时间,为Unix时间戳。生成的URL Scheme码在该时间前有效。最长有效期为1年。
  • path:通过URL Scheme码进入的小程序页面路径,必须是已经发布的小程序存在的页面,不可携带query。path为空时会跳转小程序主页。
  • query:通过URL Scheme码进入小程序时的query,最大1024个字符,只支持数字,大小写英文以及部分特殊字符.

返回值

返回小程序URL Scheme码

示例代码

type WxJumpWxa  struct {
   Path  string     `json:"path"`//通过scheme码进入的小程序页面路径
   Query string     `json:"query"` //通过scheme码进入小程序时的query
}
type WxUrlSchemeReq struct {
   Jump_wxa      WxJumpWxa `json:"jump_wxa"`//跳转到的目标小程序信息
   Is_expire     bool      `json:"is_expire"` //到期失效:true,永久有效:false
   Expire_type    int64         `json:"expire_type"`//失效时间:0,失效间隔天数:1
   Expire_time    int64         `json:"expire_time"`//到期失效的 scheme 码的失效时间,为 Unix 时间戳
   Expire_interval    int64     `json:"expire_interval"`//到期失效的 scheme 码的失效间隔天数
}
type WxUrlSchemeRet struct {
   ErrCode       int64         `json:"errcode"`
   ErrMsg        string        `json:"errmsg"`
   Openlink      string        `json:"openlink"`
}
//生成页面Scheme码
func HandlerUrlScheme(w http.ResponseWriter, r *http.Request) {
   //page路径必须为已发布的小程序页面路径
   page := r.FormValue("page");
   //通过scheme码进入小程序时的query
   query := r.FormValue("query");

   var req  WxUrlSchemeReq
   req.Is_expire = true
   req.Expire_type = 0
   req.Expire_time = time.Now().AddDate(0, 0, 30).Unix()
   req.Jump_wxa.Path = page
   req.Jump_wxa.Query = query
   paramstr, _ := json.Marshal(req)
   fmt.Println(string(paramstr))

   wx_addr := "https://api.weixin.qq.com/wxa/generatescheme"
   wx_addr += "?access_token=" + GetWxToken()
   fmt.Println(wx_addr)
   res, err := http.Post(wx_addr, "charset=UTF-8", bytes.NewBuffer(paramstr))
   if err != nil {
      fmt.Println(err)
      http.Error(w, "微信请求错误", http.StatusInternalServerError)
      return
   }

   raw, err := ioutil.ReadAll(res.Body)
   res.Body.Close()
   if err != nil {
      fmt.Println(err)
      http.Error(w, "微信返回错误", http.StatusInternalServerError)
      return
   }
   fmt.Println(string(raw))

   var ret WxUrlSchemeRet
   err = json.Unmarshal(raw, &ret)
   if err != nil {
      fmt.Println(err)
      http.Error(w, "微信返回错误", http.StatusInternalServerError)
      return
   }

   w.Write([]byte(ret.Openlink))
}

9.3.2小程序URL Scheme码的使用

urlscheme.generate生成的URL Scheme如下所示:
weixin://dl/business/?t= *TICKET*
IOS系统支持识别URL Scheme,可在短信等应用场景中直接通过URL Scheme跳转小程序。Android系统不支持直接识别URL Scheme,用户无法通过URL Scheme正常打开小程序。开发者需要使用H5页面中转,再跳转到URL Scheme来打开小程序,跳转连接的格式如下所示:
location.href = 'weixin://dl/business/?t= *TICKET*'
但是当我们短信或邮件中打开跳转链接时,是无法确定用户所使用的的手机设备是IOS还是Android,因此我们从实际的业务触发,都需要一个H5页面进行中转处理。
说明:

  • 通过URL Scheme打开小程序的场景值为 1065。
  • 微信内的网页如需打开小程序请使用微信开放标签-小程序跳转按钮,无公众号也可以直接使用小程序身份开发网页并免鉴权跳转小程序。符合开放范围的小程序可以下发支持打开小程序的短信。
  • 只能生成已发布的小程序的URL Scheme。
  • 通过URL Scheme跳转到微信时,会触发系统弹框询问,若用户选择不跳转,则无法打开小程序。请开发者妥善处理用户选择不跳转的场景。

有关微信小程序开发实战9_3 小程序URL Scheme的更多相关文章

  1. ruby - 在 Ruby 程序执行时阻止 Windows 7 PC 进入休眠状态 - 2

    我需要在客户计算机上运行Ruby应用程序。通常需要几天才能完成(复制大备份文件)。问题是如果启用sleep,它会中断应用程序。否则,计算机将持续运行数周,直到我下次访问为止。有什么方法可以防止执行期间休眠并让Windows在执行后休眠吗?欢迎任何疯狂的想法;-) 最佳答案 Here建议使用SetThreadExecutionStateWinAPI函数,使应用程序能够通知系统它正在使用中,从而防止系统在应用程序运行时进入休眠状态或关闭显示。像这样的东西:require'Win32API'ES_AWAYMODE_REQUIRED=0x0

  2. ruby - 如何指定 Rack 处理程序 - 2

    Rackup通过Rack的默认处理程序成功运行任何Rack应用程序。例如:classRackAppdefcall(environment)['200',{'Content-Type'=>'text/html'},["Helloworld"]]endendrunRackApp.new但是当最后一行更改为使用Rack的内置CGI处理程序时,rackup给出“NoMethodErrorat/undefinedmethod`call'fornil:NilClass”:Rack::Handler::CGI.runRackApp.newRack的其他内置处理程序也提出了同样的反对意见。例如Rack

  3. ruby - 在 Ruby 中编写命令行实用程序 - 2

    我想用ruby​​编写一个小的命令行实用程序并将其作为gem分发。我知道安装后,Guard、Sass和Thor等某些gem可以从命令行自行运行。为了让gem像二进制文件一样可用,我需要在我的gemspec中指定什么。 最佳答案 Gem::Specification.newdo|s|...s.executable='name_of_executable'...endhttp://docs.rubygems.org/read/chapter/20 关于ruby-在Ruby中编写命令行实用程序

  4. ruby - 使用 C 扩展开发 ruby​​gem 时,如何使用 Rspec 在本地进行测试? - 2

    我正在编写一个包含C扩展的gem。通常当我写一个gem时,我会遵循TDD的过程,我会写一个失败的规范,然后处理代码直到它通过,等等......在“ext/mygem/mygem.c”中我的C扩展和在gemspec的“扩展”中配置的有效extconf.rb,如何运行我的规范并仍然加载我的C扩展?当我更改C代码时,我需要采取哪些步骤来重新编译代码?这可能是个愚蠢的问题,但是从我的gem的开发源代码树中输入“bundleinstall”不会构建任何native扩展。当我手动运行rubyext/mygem/extconf.rb时,我确实得到了一个Makefile(在整个项目的根目录中),然后当

  5. ruby-on-rails - Rails 应用程序之间的通信 - 2

    我构建了两个需要相互通信和发送文件的Rails应用程序。例如,一个Rails应用程序会发送请求以查看其他应用程序数据库中的表。然后另一个应用程序将呈现该表的json并将其发回。我还希望一个应用程序将存储在其公共(public)目录中的文本文件发送到另一个应用程序的公共(public)目录。我从来没有做过这样的事情,所以我什至不知道从哪里开始。任何帮助,将不胜感激。谢谢! 最佳答案 无论Rails是什么,几乎所有Web应用程序都有您的要求,大多数现代Web应用程序都需要相互通信。但是有一个小小的理解需要你坚持下去,网站不应直接访问彼此

  6. ruby - 无法运行 Rails 2.x 应用程序 - 2

    我尝试运行2.x应用程序。我使用rvm并为此应用程序设置其他版本的ruby​​:$rvmuseree-1.8.7-head我尝试运行服务器,然后出现很多错误:$script/serverNOTE:Gem.source_indexisdeprecated,useSpecification.Itwillberemovedonorafter2011-11-01.Gem.source_indexcalledfrom/Users/serg/rails_projects_terminal/work_proj/spohelp/config/../vendor/rails/railties/lib/r

  7. ruby-on-rails - Rails 应用程序中的 Rails : How are you using application_controller. rb 是新手吗? - 2

    刚入门rails,开始慢慢理解。有人可以解释或给我一些关于在application_controller中编码的好处或时间和原因的想法吗?有哪些用例。您如何为Rails应用程序使用应用程序Controller?我不想在那里放太多代码,因为据我了解,每个请求都会调用此Controller。这是真的? 最佳答案 ApplicationController实际上是您应用程序中的每个其他Controller都将从中继承的类(尽管这不是强制性的)。我同意不要用太多代码弄乱它并保持干净整洁的态度,尽管在某些情况下ApplicationContr

  8. ruby-on-rails - 如何在我的 Rails 应用程序 View 中打印 ruby​​ 变量的内容? - 2

    我是一个Rails初学者,但我想从我的RailsView(html.haml文件)中查看Ruby变量的内容。我试图在ruby​​中打印出变量(认为它会在终端中出现),但没有得到任何结果。有什么建议吗?我知道Rails调试器,但更喜欢使用inspect来打印我的变量。 最佳答案 您可以在View中使用puts方法将信息输出到服务器控制台。您应该能够在View中的任何位置使用Haml执行以下操作:-puts@my_variable.inspect 关于ruby-on-rails-如何在我的R

  9. Ruby Sinatra 配置用于生产和开发 - 2

    我已经在Sinatra上创建了应用程序,它代表了一个简单的API。我想在生产和开发上进行部署。我想在部署时选择,是开发还是生产,一些方法的逻辑应该改变,这取决于部署类型。是否有任何想法,如何完成以及解决此问题的一些示例。例子:我有代码get'/api/test'doreturn"Itisdev"end但是在部署到生产环境之后我想在运行/api/test之后看到ItisPROD如何实现? 最佳答案 根据SinatraDocumentation:EnvironmentscanbesetthroughtheRACK_ENVenvironm

  10. ruby - 是否可以覆盖 gemfile 进行本地开发? - 2

    我们的git存储库中目前有一个Gemfile。但是,有一个gem我只在我的环境中本地使用(我的团队不使用它)。为了使用它,我必须将它添加到我们的Gemfile中,但每次我checkout到我们的master/dev主分支时,由于与跟踪的gemfile冲突,我必须删除它。我想要的是类似Gemfile.local的东西,它将继承从Gemfile导入的gems,但也允许在那里导入新的gems以供使用只有我的机器。此文件将在.gitignore中被忽略。这可能吗? 最佳答案 设置BUNDLE_GEMFILE环境变量:BUNDLE_GEMFI

随机推荐