DM说一说插件

DM_MESSAGE说一说插件krpano 1.18以上

简述

  •  dm_message是一款krpano全景标注型说一说留言插件。
  • 插件配置全部由krpano xml代码完成,无需对html文件和js文件进行修改和配置。代码引入后直接使用,无需在后台申请项目等动作,系统会自动识别不同项目,极大简化开发过程。
  • 支持随视角隐藏说一说热点(当前视角中心区域的说一说条目清晰可见,而四周边缘区域的说一说透明度逐渐降低),可以指定透明范围。
  • 可自定义说一说的头像、文本、标注竖线等样式(也可以采用默认样式)。可自定义输入框样式。所有样式均采用krpano style来定义。
  • 在PC浏览器中使用qq和新浪微博进行授权登陆;在微信app中使用微信一键登录;在手机qq中使用qq一键登录;在新浪微博app中使用新浪微博一键登录。
  • 在微信、手机qq、手机微博跳转到第三方授权成功后再次返回到全景中可维持授权之前视角和场景,并自动打开说一说窗口。在PC中以弹窗方式授权,不会再次刷新全景。第三方登录有插件发卡方维护,无需再申请和开发各个平台的授权登录系统。

 

演示地址

 

安装方法

  1. 复制dm_message.js文件到主目录下的plugins文件夹。
  2. 在主xml中放入以下代码,在scene标签外即可。key属性填写自己的key。
  3. 添加说一说换一批说一说隐藏或显示说一说三种按钮中添加插件方法。
  4. 使用专门的style.xml进行留言界面的样式设定,首先在主xml中include该xml
    对style.xml内容进行修改。
     

插件属性与方法

插件属性

属性名 完整属性名 类型 默认值
key plugin[name].key String
可联系肥宗申请,点赞key可通用
属性名 完整属性名 类型 默认值
auto_hide plugin[name].auto_hide Boolean  true
是否启用靠边自动透明度true/false
启用后说一说热点元素越靠近边缘透明度越低。
属性名 完整属性名 类型 默认值
auto_hide_area_h plugin[name].auto_hide_area_h Number  0.3
水平靠边自动透明度启用比例(0~0.5)
例如:
当auto_hide=”true”,auto_hide_area_h=”0.2″时,热点靠水平边缘任意一边小于20%就开始启用透明度,靠边大于20%透明度为1,热点月接近边缘透明度越低,最边缘透明度为0水平
属性名 完整属性名 类型 默认值
auto_hide_area_v plugin[name].auto_hide_area_v Number 0.3
垂直靠边自动透明度启用比例(0~0.5)
例如:
当auto_hide=”true”,auto_hide_area_h=”0.2″时,热点靠垂直边缘任意一边小于20%就开始启用透明度,靠边大于20%透明度为1,热点月接近边缘透明度越低,最边缘透明度为0
属性名 完整属性名 类型 默认值
get_mode plugin[name].get_mode String onloadcomplete
定义获取说一说数据的事件。

  • onnewscene

在onnewscene(新场景)事件后获取说一说数据

  • onxmlcomplete

在onxmlcomplete(xml或者新场景的xml加载完成)事件后获取说一说数据

  • onpreviewcomplete

在onpreviewcomplete(预览图加载完成)事件后获取说一说数据

  • onloadcomplete 推荐使用

在onloadcomplete(全景图加载完成)事件后获取说一说数据

  • none

不获取说一说数据 需要通过get_message()方法手动获取说一说数据

属性名 完整属性名 类型 默认值
get_delayed plugin[name].get_delayed Number 0.0
get_mode事件后的延时获取说一说数据时间,单位为秒。
属性名 完整属性名 类型 默认值
message_visible plugin[name].message_visible Boolean  true
是否显示说一说热点true/false
例如显示说一说:onclick=”set(plugin[name].message_visible,true);”
属性名 完整属性名 类型 默认值
total plugin[name].total Number 50
 每次获取的说一说条数1~100

 

插件方法

方法名 数值类型 默认值
plugin[name].add() Action
  • 添加说一说

执行后系统会判断当前用户是否登录,如果登录,会直接弹出标注和输入框。如果没登录在PC网页上会弹出qq和微博的授权登录按钮,点击后会弹出qq或微博的授权页面。在微信、手机qq、微博app上会直接跳转到相应的授权登录页面。授权后将返回到全景页面。

属性名 数值类型 默认值
plugin[name].load() Action
  • 手动加载全景数据。

在get_mode=”false”(不自动获取全景数据),需要使用该方法手动获取说一说数据

属性名 数值类型 默认值
plugin[name].flip() Action
  • 换一批说一说数据。

插件事件

属性名 完整属性名 类型 默认值
onbadword plugin[name].onbadword Action 
当用户提交的留言有敏感词时响应此事件
属性名 完整属性名 类型 默认值
onmessageloaded plugin[name].onmessageloaded Action 
当用留言数据获取完成时响应此事件
属性名 完整属性名 类型 默认值
onauthorizeshow plugin[name].onauthorizeshow Action
当弹出授权按钮提示时响应此事件

 

插件样式

插件中所有元素样式都可以自定义,如果不定义,将采用默认样式,如果需要定义,可参考如下样式进行定义,所有样式必须按照下表名称进行定义

样式名 说明 元素类型
pc_authorize_win PC端弹出授权框背景样式 layer/plugin
  • <style name=”pc_authorize_win”

    />
  • 必须属性:
    • name=”pc_authorize_win
样式名 说明 元素类型
pc_qq_btn PC端qq授权按钮样式 layer/plugin
  • <style name=”pc_qq_btn”parent=”pc_authorize_win”…

    />

  • 必须属性:
    • name=”pc_qq_btn” 
    • parent=”pc_authorize_win” 
样式名 说明 元素类型
pc_sain_btn PC端微博授权按钮样式 layer/plugin
  • <style name=”pc_sain_btn”parent=”pc_authorize_win”…

    />

  • 必须属性:
    • name=”pc_sain_btn” 
    • parent=”pc_authorize_win” 
样式名 说明 元素类型
dm_say_line 标注竖线样式 hotspot
  • <style name=”dm_say_line”…/>
  • 必须属性:
    • name=”dm_say_line” 
样式名 说明 元素类型
dm_say_tx 头像样式 hotspot
  • <style name=”dm_say_tx”…/>
  • 必须属性:
    • name=”dm_say_line” 
样式名 说明 元素类型
dm_say_bg 文字背景样式 hotspot/text
  • <style name=”dm_say_bg”…/>
  • 必须属性:
    • name=”dm_say_bg” 
样式名 说明 元素类型
dm_say_edit_line 编辑状态下标注竖线样式 hotspot
  • <style name=”dm_say_edit_line”…/>
  • 必须属性:
    • name=”dm_say_edit_line” 
样式名 说明 元素类型
dm_say_edit_tx 编辑状态下头像样式 hotspot
  • <style name=”dm_say_edit_tx”…/>
  • 必须属性:
    • name=”dm_say_edit_tx” 
样式名 说明 元素类型
dm_say_edit_bg 编辑状态文字背景样式 hotspot/text
  • <style name=”dm_say_edit_bg”paddingleft=”35″paddingright=”5″

    />

  • 必须属性:
    • name=”dm_say_edit_bg” 

     

  •  特有属性:
    • paddingleft=”35″

    输入框左内边距

    • paddingright=”5″

         输入框右内边距

样式名 说明 元素类型
dm_say_submit_btn 提交按钮样式  layer/plugin/text
  • <style name=”dm_say_submit_btn”…

    />

  • 必须属性:
    • name=”dm_say_submit_btn” 
样式名 说明 元素类型
dm_say_submit_btn_enabled 提交按钮不可用样式  layer/plugin/text
  • <style name=”dm_say_submit_btn_enabled”…

    />

  • 必须属性:
    • name=”dm_say_submit_btn_enabled” 
样式名 说明 元素类型
dm_say_cancel_btn 取消按钮样式  layer/plugin/text
  • <style name=”dm_say_cancel_btn”…

    />

  • 必须属性:
    • name=”dm_say_cancel_btn” 

购买方式

  1. 微信联系站长
  2. 支付299元可享受一年时间同一个域名下不受项目个数限制的说一说插件使用服务。
  3. 已经购买了基础299元的用户,支付129元可新增一个域名的一年服务。
  4. 单个项目永久使用费用为60元一个。