多产品

商业工具扩展开发指南

最新更新时间:9262023

上头商务工具扩展提供所有后端功能连接云工具并同步从云工具到商务工具云状资产备妥供你上商务工具网站或a

为使任务更容易化,扩展提供数个即时React组件供前端显示产品资产获取最新发布版本的更多信息cloudinary_commercetools/componentsGitHub库

并查查演示文集应用展示使用这些React组件复制并粘贴相关片段源码易实现性

商业工具扩展React组件

AcsetRender

上头AcsetRenderAsset标签和内容类型检验,确定它是否图像、视频或旋翼并相应制作

数组资产从商务工具显示

举个例子GitHub显示适当的资产类型如何在旋转木马上实现

所需参数

参数 类型 描述性
资产类 对象类 资产组件显示

可选参数

参数 类型 描述性
宽度 数目 宽度显示资产
高度显示 数目 高度显示资产
shumbnail系统 布尔 if true小版本显示
类Name 字符串 添加类实现输出

资产映射

上头资产映射全尺寸图像或缩略图版视输入而定未提供宽度或高度的缩略图默认大小为600x700或136x142

所需参数

参数 类型 描述性
公共标识 字符串 公共标识元件显示

可选参数

参数 类型 描述性
宽度 数目 宽度显示资产
高度显示 数目 高度显示资产
shumbnail系统 布尔 if true小版本显示

注解
额外调用云化API请求资产原创维度并计算通过请求优化云化版本保存带宽量信息显示时点击左上角图标

AssetVideo

上头AssetVideo显示视频组件宽度和高度未提供宽度或高度的缩略图默认大小为600x700或136x142

缩略图组件叠加图像作为播放按钮

注解
确定您上传播放按钮图像到产品环境时公共标识匹配代码中指定叠加图像的名称,例如 play-icon-white-png-8_jajw2z中此 硬编码叠加.

所需参数

参数 类型 描述性
公共标识 字符串 公共标识元件显示

可选参数

参数 类型 描述性
宽度 数目 宽度显示资产
高度显示 数目 高度显示资产
shumbnail系统 布尔 if true小版本显示

资产spinset

安市资产spinset允许用户环绕中心轴旋转产品为了显示360旋转集,产品库部件用标签获取所有图像(例如并合并成单个实体, 将每张图像列成360转集单框(按公有标识排序字母数分解)。

缩略图组件叠加图像作为导航按钮

注解
确定向产品环境上传导航按钮图像,公共标识匹配代码中指定叠加图像的名称,例如 360-overlay-black_mjok7x中此 硬编码叠加.

所需参数

参数 类型 描述性
标识符 字符串 独有的spring集标识符,万一页面上多子串集
公共标识 字符串 公有资产标识符
标签标签 字符串数组 云状资产中所有标签
资产将使用springset中,如果数组中存在独有springset-tag

可选参数

参数 类型 描述性
宽度 数目 宽度显示资产
高度显示 数目 高度显示资产
shumbnail系统 布尔 if true小版本显示

唯一一个旋转集图像必须连接商务工具产品资产,因为剩余旋转集直接从云形装入

产品资产信息

设置构件时, 无论是商业工具扩展响应或定制, 您需要传递产品信息并传递相关资产信息 。在您的项目中,有很多方法可以检索这些信息,例如通过自己的API连接商务工具

下示例显示如何通过向相关商务工具端点发送请求获取信息

实例

要通过标识选择商业工具产品,发送下列HTTP请求

取回产品资产时可具体说明产品.matest.Data.matestVariant.asset

样本响应

注解
商业工具文档了解更多信息

用例

下段只突出几种方式使用商务工具扩展能力可选择执行这些案例中的任何案例,并可定制基于自身具体需要的任何解决方案。

造云产品美术馆

集成提供帮助者方法商务工具产品资产信息传递

输入时需要提供商业工具产品资产信息.资产见商工具产品变换级例举 :

  • 产品Tie印制最大礼服
    • 变换式
    • SKU11001
    • SKU11002(红色,体积39)
    • SKU11003
    • SKU11011
    • .

每种变换都有资产列表每一资产都:

  • 数组源码,
    • URI存储云资产公共标识
    • 内容类型显示资产是图像或视频或别的东西
      注解
      资产支持多源存储信息,例如不同尺寸辅助者方法使用自动重定大小,因此只取数组资产源的第一个元素
    • 名声
    • 数组标签中包含此资产云式标签

注解

Render自定义产品库

制作定制产品画廊时,可采取下列步骤:

  1. 获取产品资产信息.
  2. 从响应检索
    • 上头标识符中位资产
    • 上头里头中位资产
    • 上头内容类型中位资产
  3. 可使用商务工具扩展资产映射,AssetVideo资产spinset组件生成图片、视频和旋翼供产品画廊使用
    • 设置缩略图将资产设为缩略图ythumnail系统参数切换真实性.
    • 通过设置宽高参数控制资产大小
  4. 确定资产类型以确保与相容组件相容自动使用AcsetRender构件或人工检查内容类型参数资产
  5. 信息检索显示

注解
演示应用完全使用云产品库,因此不显示定制产品库

出产品图像 PDP和PL

  1. 获取产品资产信息.
  2. 从响应检索
    • 上头标识符中位资产
    • 上头里头中位资产
    • 上头排序指令内存图像
  3. 商业工具扩展资产映射反应组件生成单个图片 产品库按规定顺序或生成图像
    注解
    更多资料显示云产品库图片 发布资产.
  4. 可选设置缩略图ythumnail系统参数切换真实性.
  5. 可选择控制资产大小,设置宽度和高度参数
  6. 确定资产为图像后使用AssetImaage组件自动使用AcsetRender构件或人工检查内容类型参数资产

注解
查看图像使用AssetImaage组件生成实例 云性演示应用源码.

Render视频 PDP

  1. 获取产品资产信息.
  2. 从响应检索
    • 上头标识符中位资产
    • 上头里头中位资产
    • 上头排序指令中位资产
  3. 商业工具扩展AssetVideo反应组件生成单个视频 产品画廊按规定顺序
    注解
    更多资料显示云产品库视频 视频播放.
  4. 可选设置缩略图ythumnail系统参数切换真实性.
  5. 可选择控制资产大小,设置宽度和高度参数
  6. 确定资产为视频后带AssetVideo组件自动使用AcsetRender构件或人工检查内容类型参数资产

注解
实例显示视频使用AssetVideo组件制作 云性演示应用并选择视频组件 源码.

3D模型和360旋转套

  1. 获取产品资产信息.
  2. 从响应检索
    • 上头标识符中位资产
    • 上头里头中位资产
    • 上头排序指令中位资产
  3. 商业工具扩展资产映射资产spinset反应组件生成单个资产 产品画廊按规定顺序
    注解
    更多资料显示云产品库的旋翼转换见 360旋转集.
  4. 可选设置缩略图ythumnail系统参数切换真实性.
  5. 可选择控制资产大小,设置宽度和高度参数
  6. 确定资产类型以确保与相容组件相容自动使用AcsetRender构件或人工检查内容类型参数资产

注解

ender响应图像、视频和产品集

所有商务工具扩展React组件基于云性能力并自动完全响应

欲了解更多产品图片库响应图像、视频和旋环信息,见响应性资产.

设置alt文本

  1. 获取产品资产信息.
  2. 从响应检索
    • 上头标识符中位资产
    • 上头里头中位资产
    • 上头单调图文中位资产
  3. 商业工具扩展资产映射反动组件生成单个图片并随同指定的alt文本

注解
演示应用完全使用云产品库,因此不使用此组件然而,你可以看到 单行代码需要执行此操作 。

反馈发送

评分本页 :