chore(微信视频号): 优化channel-video组件的显示,更新技术文档
This commit is contained in:
@@ -204,17 +204,20 @@ if (typeof wx !== 'undefined' && wx.openChannelsActivity) {
|
||||
|
||||
- 组件调用无资质要求
|
||||
- 暂不支持纯图片视频号内容
|
||||
- 在 UniApp 中使用时,需要用 `<native-component>` 包裹以确保组件正确显示
|
||||
|
||||
```vue
|
||||
<!-- #ifdef MP-WEIXIN -->
|
||||
<channel-video
|
||||
feed-id="{{feedId}}"
|
||||
finder-user-name="{{finderUserName}}"
|
||||
feed-token="{{feedToken}}"
|
||||
bindenterfullscreen="enterFullscreen"
|
||||
bindexitfullscreen="exitFullscreen"
|
||||
binderror="videoError"
|
||||
></channel-video>
|
||||
<native-component>
|
||||
<channel-video
|
||||
feed-id="{{feedId}}"
|
||||
finder-user-name="{{finderUserName}}"
|
||||
feed-token="{{feedToken}}"
|
||||
bindenterfullscreen="enterFullscreen"
|
||||
bindexitfullscreen="exitFullscreen"
|
||||
binderror="videoError"
|
||||
></channel-video>
|
||||
</native-component>
|
||||
<!-- #endif -->
|
||||
```
|
||||
|
||||
@@ -274,6 +277,7 @@ if (typeof wx !== 'undefined' && wx.openChannelsActivity) {
|
||||
- 跳转打开视频号视频需要微信小程序基础库版本 2.19.2 及以上
|
||||
- 内嵌视频号视频需要微信小程序基础库版本 2.25.1 及以上
|
||||
- 小程序与视频号关联仅在需要内嵌非同主体视频号视频(基础库 2.31.1 以下)时需要
|
||||
- 必须确保在 `manifest.json` 中设置 `usingComponents: true` 以启用组件支持
|
||||
|
||||
### 5.2 数据格式
|
||||
|
||||
@@ -334,6 +338,58 @@ if (typeof wx !== 'undefined' && wx.openChannelsActivity) {
|
||||
- 在其他环境中,组件会显示但无法播放视频
|
||||
- 建议在非小程序环境中添加友好的提示信息
|
||||
|
||||
### 6.7 在uni-app中使用原生组件时,可能会遇到组件不显示的问题
|
||||
|
||||
在uni-app中使用原生组件时,可能会遇到组件不显示的问题。以下是已验证的解决方案:
|
||||
|
||||
#### 解决方案
|
||||
|
||||
**方法一:使用 `<native-component>` 包裹**
|
||||
|
||||
在 UniApp 中使用 `channel-video` 组件时,必须用 `<native-component>` 包裹以确保组件正确显示:
|
||||
|
||||
``` vue
|
||||
<template>
|
||||
<view>
|
||||
<!-- #ifdef MP-WEIXIN -->
|
||||
<native-component>
|
||||
<channel-video
|
||||
feed-id="{{feedId}}"
|
||||
finder-user-name="{{finderUserName}}"
|
||||
feed-token="{{feedToken}}"
|
||||
style="width: 100%; height: 320rpx;"
|
||||
></channel-video>
|
||||
</native-component>
|
||||
<!-- #endif -->
|
||||
</view>
|
||||
</template>
|
||||
```
|
||||
|
||||
**方法二:检查 `manifest.json` 配置**
|
||||
|
||||
确保在 `manifest.json` 文件中正确设置了 `usingComponents: true`,特别是在 `mp-weixin` 部分:
|
||||
|
||||
``` json
|
||||
"mp-weixin": {
|
||||
"appid": "你的小程序appid",
|
||||
"usingComponents": true,
|
||||
// 其他配置...
|
||||
}
|
||||
```
|
||||
|
||||
**方法三:检查微信小程序基础库版本**
|
||||
|
||||
确保微信小程序基础库版本满足要求:
|
||||
- 跳转打开视频号视频需要基础库版本 2.19.2 及以上
|
||||
- 内嵌视频号视频需要基础库版本 2.25.1 及以上
|
||||
|
||||
**方法四:检查参数是否正确**
|
||||
|
||||
确保传递给 `channel-video` 组件的参数正确:
|
||||
- `feedId`:视频号内容ID,必填
|
||||
- `finderUserName`:视频号ID,可选
|
||||
- `feedToken`:非同主体视频号视频的标识,可选(基础库 2.31.1+)
|
||||
|
||||
## 7. 示例代码
|
||||
|
||||
### 7.1 单个视频号示例
|
||||
|
||||
Reference in New Issue
Block a user