YLNewsSDK 1.1.2

YLNewsSDK 1.1.2

wangweipeng维护。



YLNewsSDK 1.1.2

有料信息流SDK-iOS平台接入文档

##示例 demo 地址:https://github.com/YLNewsSDK-iOS/sdkTest

一、添加SDK及三方依赖

使用cocoapods管理(升级cocoapods为cdn搜索及配置)(推荐使用)

1.Podfile文件:

pod 'YLNewsSDK'

二、初始化及使用方法

1.在接入时引入SDK头文件 #import <YLNewsSDK/YLNewsSDK.h>

2.强类型对象

@property(strong ,nonatomic)YLNewsSDK *yl_newssdk;

3.初始化方法 示例

///第一步
///配置参数  此配置若无要求可不传
[YLNewsSDKModeManager shareManager].isHoverMode = YES;  //是否是悬停效果 默认为NO
[YLNewsSDKModeManager shareManager].isHaveTabbar = YES;   //是否有tabbar 默认为NO
[YLNewsSDKModeManager shareManager].isHaveNav = YES;  //是否有导航栏 默认为NO
[YLNewsSDKModeManager shareManager].isNeedRefreashButton = YES;  //是否需要刷新按钮 默认为NO
[YLNewsSDKModeManager shareManager].host_cus_navbar_height = @(navibarHeight); //设置导航栏高度
[YLNewsSDKModeManager shareManager].host_theme_color = @"0000FF";//动态修改主题色
///第二步
/// 入口方法
/// @param appid appid
/// @param apikey apikey
/// @param tabType 信息流类型(新闻:YLNewsType;视频:YLVideoType)
/// @param city 当前城市:尽量不要为nil
/// @param hostVC 宿主控制器

self.yl_newssdk = [[YLNewsSDK alloc]initWithAppid:@"7c8b8eae081d36cb"
                                            andApikey:@"7030160a7c2e2bfefcab1d23eaf3641d"
                                           andTabType:YLNewsType
                                         andLocalCity:@"北京"
                                andHostViewController:self];
/// 第三步
/// 触发加载信息流方法
[self.yl_newssdk loadData];

4.针对悬浮效果的回调--信息流拉到顶部时触发 示例

self.yl_newssdk.newsListScrollToTopBlock = ^(NSDictionary *scrollToTopDic) {
        //通知信息流 此时宿主可根据自身需要控制信息流是否可滑动 yl_news_list_can_not_scroll:为不可滑动, yl_news_list_can_scroll:为可滑动 注:只可用此两个通知消息不可随意命名
        eg: 宿主APP 可根据自身滚动界面的位置进行相应操作
        [[NSNotificationCenter defaultCenter] postNotificationName:@"yl_news_list_can_not_scroll" object:nil];
    };

5.分享部分代码示例

    self.yl_newssdk.shareBlock = ^(NSDictionary *shareSourceDic) {
        NSLog(@"接收到分享内容 == %@",shareSourceDic);
        
    };

不使用cocoapods的情况(不推荐,配置时很容易出错)

1:需将示例demo中的YLNewsSDK文件夹下的framework及bundle资源文件复制进项目
2:从穿山甲广告官网 (http://partner.toutiao.com) 对接中心下载最新SDKdemo,将穿山甲SDK及bundle文件放置于一个名为BUAdSDK-UnionAD的文件夹中,并全部复制到项目中。 3:从微信开放平台和QQ开放平台下载WechatOpenSDK和TencentOpenApiSDK,并将SDK复制到项目中

三、自定义配置规范

可在bundle资源文件下的HostCustom.plist文件中进行配置,以下是对配置字段的说明(注:1:plist文件中的字段Key及Type不可更改!!!只需自定义Value。2:更新sdk时,bundle文件会恢复为默认值,因此可以创建保存同名plist文件用以覆盖bundle,避免重复修改配置)

TabTitleColor              //滚动标签条文字未选中颜色

TabTitleSelectColor        //滚动标签条文字选中颜色

TabTitleFont               //滚动标签条文字未选中大小

TabTitleSelectFont         //滚动标签条文字选中大小

NewsMenuViewHeight         //滚动标签条高度

TopTipBackColor            //更新提示背景颜色

TopTipTextColor            //更新提示文字颜色

ChooseCityTipBackColor     //选择城市提示背景颜色

ChooseCityTipTextColor     //选择城市提示文字颜色

DetailPageProgressColor    //详情页加载进度条颜色

NewsTitleFont              //新闻标题字体大小

NewsTitleColor             //新闻标题字体颜色

NewsAuthorFont             //新闻作者字体大小             

NewsAuthorColor            //新闻作者字体颜色 

NewsLeftRightSpacing       //信息流界面左右间距

NewsImageCornerRadius      //信息流界面图片圆角

DislikeTextColor           //dislike负反馈-原因按钮文字未选中颜色

DislikeTextSelectColor     //dislike负反馈-原因按钮文字选中颜色

DislikeRimColor            //dislike负反馈-原因按钮边框颜色

DislikeRimSelectColor      //dislike负反馈-原因按钮边框选中颜色

DislikeBackColor           //dislike负反馈-原因按钮背景未选中颜色

DislikeBackSelectColor     //dislike负反馈-原因按钮背景选中颜色

DislikeSubmitBackColor     //dislike负反馈-确定提交按钮背景颜色