# @getnori/feed 中文文档

规范地址：https://npmcn.com/package/%40getnori/feed/

版本：0\.13\.0
npm 元数据更新时间：2026-11-13T07:16:02.832Z
中文译文更新时间：2026-11-16T06:29:05.389Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40getnori/feed
原文对照：https://npmcn.com/package/%40getnori/feed/?lang=original
项目主页：https://github.com/ad-yuta/nori-sdk#readme
源码仓库：https://github.com/ad-yuta/nori-sdk

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：484 kB，15 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：react \>=18，react-dom \>=18，react-native \>=0\.74，react-native-web \>=0\.19，react-native-video \>=6\.0\.0
- 首次发布：2026-10-20T17:58:58.505Z
- 最新版本发布：2026-11-13T07:16:02.627Z
- 近 30 天下载量：3882（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

Nori Feed SDK:用于React Independent apps的全屏相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机.

## 安装

```sh
npm install @getnori/feed
```

也可以使用：`pnpm add @getnori/feed`、`yarn add @getnori/feed`、`bun add @getnori/feed`

## README

# @ getnori/ feed (韩语)

为React Independent apps提供全屏,垂直分页的回放回放. 它弹奏 可见的相片,暂停其余部分,并报告视图,以便诺里API奖励 观者.

```sh
npm install @getnori/core @getnori/feed react-native-video
```

```tsx
import { createNoriClient } from "@getnori/core";
import { NoriFeed } from "@getnori/feed";

const nori = createNoriClient({ publishableKey: "pk_live_...", getViewerToken });

export function IdeasTab() {
  return <NoriFeed client={nori} tag="home" />;
}
```

## 道具

| Prop | 默认 |  |
| --- | --- | --- |
| `client` | 所需经费 | 从 `createNoriClient` |
| `tag` | 全卷轴 | 只有这个标签的胶卷。 修复过滤器, 所以没有显示收藏芯片 |
| `collections` | `true` | 当企业在一个以上的收藏中拥有了All / Tour / Menu / Revers 芯片时, 在相片上显示 All / Tour / Menu / Revers 芯片(见下文) |
| `pageSize` | 10个 | 每项请求 |
| `muted` | `false` |  |
| `height` | 父高 | 固定回旋高度 |
| `renderOverlay` | 无 | 画出每一卷 `{ reel, active, positionMs, durationMs }`这是商业产品卡和奖章的去处 |
| `onReelChange` | 无 | 可见的相片已更改 |
| `renderEmpty` | "还没到" |  |
| `renderHoldout` | 无 | Holdout 查看器( 实验的控制组) 无法获得种子; 显示您通常的内容 |

颜色来自您的租户主题( C)`background_color`, (中文(简体) ), `text_color`, (中文(简体) ), `primary_color`) (中文(简体) ).

## 网络上的完整视图 : `NoriReels`

在网站上,饲料通常坐落在主机页内,其标题下. `NoriReels` 包装 `NoriFeed` 所以,胶卷打开英寸 **完整视图**,覆盖整个窗口,a 按钮(或 Escape)将其降为页内视图和回放。 只选择更改 在页面正文中绘制出完整的视图(反应-内存-web's `Modal`),因此带有CSS变换的卷轴视图或导航器不能被困住. 正在重新挂载种子,所以在第一卷重新打开。 虽然 `paused` 它从不覆盖页面.

```tsx
import { NoriReels } from "@getnori/feed/web";
import { PointsBadge, RewardToasts } from "@getnori/rewards";

<NoriReels client={nori} renderTopRight={() => <PointsBadge client={nori} />}>
  <RewardToasts client={nori} />
</NoriReels>
```

| Prop | 默认 |  |
| --- | --- | --- |
| `defaultExpanded` | `true` | 从全景开始 |
| `expanded` 编号 : `onExpandedChange` | 无控制 | 自己控制风景 |
| `reducedHeight` | 窗口的60%, 至少420 | 缩小视图的高度 |
| `renderTopRight` | 无 | 绘制右上角, 例如 a `PointsBadge` |
| `children` | 无 | 划过地盘,比如说. `RewardToasts` |

还要花很多时间 `NoriFeed` 道具除外 `height` 财务报告和审定财务报表 `style`在iOS和Android上 feed 已经是一个全屏面板, 所以 `NoriReels` 调制 `NoriFeed` 没有切换.

### 平面 反应网络应用程序 : `NoriReelsWeb`

Vite, Next 或任何反应站点, 不反应- native- web: 从 `@getnori/feed/dom`。 。 。 . 它是相同的行为(默认的全视图,一个按钮或对已缩小的视图的逃避), 以 DOM 写成,它没有 `react-native` 依赖性。 可在 页面正文,所以一个已变形的祖先不能困住它;正在重新挂载种子.

```tsx
import { NoriReelsWeb } from "@getnori/feed/dom";

<NoriReelsWeb client={nori} renderTopRight={() => <MyPointsBadge />}>
  <MyToasts />
</NoriReelsWeb>
```

这需要 `tag`, (中文(简体) ), `pageSize`, (中文(简体) ), `paused`, (中文(简体) ), `expanded` 编号 : `defaultExpanded` 编号 : `onExpandedChange`, (中文(简体) ), `reducedHeight`, (中文(简体) ), `renderTopRight`, (中文(简体) ), `renderOverlay`, (中文(简体) ), `onReelChange`, (中文(简体) ), `renderEmpty`, (中文(简体) ), `renderHoldout` 财务报告和审定财务报表 `children`,如上. (中文(简体) ). Reels 开始变哑 (浏览器拒绝自动播放) 有声音的),而取景者可以解密. 它显示标题,产品芯片(它们链接到 产品 `deep_link` 报告 `product_tap`和reel的呼叫-行动链接,和 报告与原生饲料相同的事件和奖励. `renderOverlay` 提取过来 每个折叠层忽略指针事件; 给出自己的按钮 `pointer-events: auto`。通过 `paused` ,而种子的路线在背景.

## 报告的内容

对于可见的视频: `impression`, (中文(简体) ), `view_progress` 当它开始和在 25/50/75%和1个 `view_complete` 当观众到达你 `min_watch_percent`。服务器决定奖赏;倾听 `client.on("reward", ...)` 或用途 `@getnori/rewards`发送已排队的事件 当应用到背景.

建设自己的UI? `useFeed(client)` 页面 `createViewTracker` 将回放调用到这些事件中.

## 收款

企业的卷轴可以属于收藏品: `tour` (它自己的巡演), `menu` (每个菜单项目一卷)或 `reviews` (由观众制作). 它们是普通的标签,由诺里商行设定. 当一个企业有两本或多本作品, `NoriFeed` 财务报告和审定财务报表 `NoriReelsWeb` (这样) `NoriReels`, (中文(简体) ), `NoriTab` 财务报告和审定财务报表 `NoriTabWeb`显示 **全部/ 巡回/ 菜单/ 评论** 芯片在卷轴上;一个收藏显示没有芯片. 没有什么可以配置的:一个可以升级SDK的应用程序得到了芯片,以及后来的任何更改. `collections={false}` 和固定的 `tag` 替换它们. `client.collections()` 编辑 `useCollections` 钩有自定义视图.

## 常见问题

### @getnori/feed 是什么？

Nori Feed SDK:用于React Independent apps的全屏相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机相机\.

### 如何安装 @getnori/feed？

在项目目录运行 npm install @getnori/feed，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18）、react-dom（\>=18）、react-native（\>=0\.74）、react-native-web（\>=0\.19）、react-native-video（\>=6\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @getnori/feed 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @getnori/feed 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @getnori/feed 可以商用吗？

@getnori/feed 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @getnori/feed 的下载量有多少？

根据 npm 官方下载统计，@getnori/feed 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,882 次，日均约 129 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @getnori/feed 还在维护吗？

最新版本 0\.13\.0 发布于 2026/11/13（2 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/10/21。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

